@kkauto/kkauto-mcp 0.3.4 → 0.3.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -65
- package/dist/server.js +1 -1
- package/package.json +7 -1
package/README.md
CHANGED
|
@@ -19,11 +19,11 @@ The adapter stays thin by design: it uses the same `/api/v2/*` routes as normal
|
|
|
19
19
|
- Node.js 20 or newer.
|
|
20
20
|
- Active kkAuto API token from `/wtadmin/mcp` or `/wtadmin/token?type=api`.
|
|
21
21
|
- Tenant-aware base URL for SaaS, or the selfhost app base URL.
|
|
22
|
-
- npm/npx access to `@kkauto/kkauto-mcp@0.3.
|
|
22
|
+
- npm/npx access to `@kkauto/kkauto-mcp@0.3.5` after publish, or a local checkout for development.
|
|
23
23
|
|
|
24
24
|
## Client Setup With npx
|
|
25
25
|
|
|
26
|
-
The package release target is `@kkauto/kkauto-mcp@0.3.
|
|
26
|
+
The package release target is `@kkauto/kkauto-mcp@0.3.5`, so MCP clients can run it with `npx` without copying the website repository after publish:
|
|
27
27
|
|
|
28
28
|
Recommended setup:
|
|
29
29
|
|
|
@@ -107,69 +107,6 @@ Selfhost can use the local app URL as `KK_API_BASE_URL`, for example `https://kk
|
|
|
107
107
|
|
|
108
108
|
With `npx`, the MCP client machine only needs Node.js/npm plus access to the package registry. With local checkout mode, `args[0]` is a filesystem path on the machine running the MCP client. Do not use the web server's `/home/...` path unless the MCP client runs on that same server.
|
|
109
109
|
|
|
110
|
-
## Package Release
|
|
111
|
-
|
|
112
|
-
Prepared package release:
|
|
113
|
-
|
|
114
|
-
- Name: `@kkauto/kkauto-mcp`
|
|
115
|
-
- Version: `0.3.4`
|
|
116
|
-
- Binary: `kkauto-mcp -> dist/server.js`
|
|
117
|
-
- Expected tarball after publish: `https://registry.npmjs.org/@kkauto/kkauto-mcp/-/kkauto-mcp-0.3.4.tgz`
|
|
118
|
-
|
|
119
|
-
Package settings:
|
|
120
|
-
|
|
121
|
-
- CLI binary: `kkauto-mcp`
|
|
122
|
-
- Published files: `dist`, `README.md`, `package.json`
|
|
123
|
-
- `prepack` runs `npm run build`
|
|
124
|
-
|
|
125
|
-
Verify published metadata:
|
|
126
|
-
|
|
127
|
-
```bash
|
|
128
|
-
npm view @kkauto/kkauto-mcp version
|
|
129
|
-
npm view @kkauto/kkauto-mcp bin dist.tarball
|
|
130
|
-
```
|
|
131
|
-
|
|
132
|
-
### Trusted Publisher
|
|
133
|
-
|
|
134
|
-
Future releases should publish through GitHub Actions Trusted Publisher instead of long-lived npm tokens. Configure npmjs.com package settings for `@kkauto/kkauto-mcp`:
|
|
135
|
-
|
|
136
|
-
| Field | Value |
|
|
137
|
-
| --- | --- |
|
|
138
|
-
| Provider | GitHub Actions |
|
|
139
|
-
| Organization or user | `vthuan1889` |
|
|
140
|
-
| Repository | `kk-website` |
|
|
141
|
-
| Workflow filename | `npm-publish-mcp.yml` |
|
|
142
|
-
| Environment name | blank |
|
|
143
|
-
| Allowed actions | `npm publish` |
|
|
144
|
-
|
|
145
|
-
The repo-side workflow is `.github/workflows/npm-publish-mcp.yml`. It uses GitHub-hosted runners, `permissions.id-token: write`, Node 24, and installs npm 11 because Trusted Publisher requires npm 11.5.1+ so npm can exchange the OIDC token automatically. Trusted Publisher releases do not need `NODE_AUTH_TOKEN` or an OTP in GitHub Actions.
|
|
146
|
-
|
|
147
|
-
Release-triggered publishes require publishing a GitHub Release whose tag starts with `mcp-v`, for example `mcp-v0.3.4`. Pushing a tag alone does not publish. The release tag must match the package version as `mcp-v<version>`, and the workflow refuses to publish if that package version already exists on npm. Manual workflow dispatch is also available from `main` only and requires confirming `@kkauto/kkauto-mcp` as the publish target.
|
|
148
|
-
|
|
149
|
-
After one successful OIDC publish, prefer npm package settings that require 2FA and disallow token publishing.
|
|
150
|
-
|
|
151
|
-
Trusted Publisher release flow:
|
|
152
|
-
|
|
153
|
-
```bash
|
|
154
|
-
cd mcp
|
|
155
|
-
npm install
|
|
156
|
-
npm version patch --no-git-tag-version
|
|
157
|
-
npm test
|
|
158
|
-
npm pack --dry-run
|
|
159
|
-
```
|
|
160
|
-
|
|
161
|
-
Commit the version bump, push to `main`, then publish a GitHub Release tagged `mcp-v<version>`. The workflow installs dependencies, tests, dry-runs the package, and runs `npm publish --access public` via OIDC.
|
|
162
|
-
|
|
163
|
-
Legacy package status: the old unscoped package remains installable and `kkauto-mcp<=0.3.2` is deprecated with migration guidance. To correct that deprecation message if needed:
|
|
164
|
-
|
|
165
|
-
```bash
|
|
166
|
-
npm deprecate kkauto-mcp@"<=0.3.2" "Package moved to @kkauto/kkauto-mcp. Use: npx -y @kkauto/kkauto-mcp"
|
|
167
|
-
```
|
|
168
|
-
|
|
169
|
-
For the next release after `0.3.4`, bump the package version first, then publish.
|
|
170
|
-
|
|
171
|
-
Use `npm publish --registry <private-registry-url>` for a private registry.
|
|
172
|
-
|
|
173
110
|
## Tools
|
|
174
111
|
|
|
175
112
|
| Tool | Purpose |
|
package/dist/server.js
CHANGED
|
@@ -13,7 +13,7 @@ async function main() {
|
|
|
13
13
|
const client = new KkAutoApiClient(config);
|
|
14
14
|
const server = new McpServer({
|
|
15
15
|
name: 'kkauto-mcp',
|
|
16
|
-
version: '0.3.
|
|
16
|
+
version: '0.3.5',
|
|
17
17
|
});
|
|
18
18
|
registerFbPostTools(server, client, config);
|
|
19
19
|
registerSourcePostTools(server, client, config);
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@kkauto/kkauto-mcp",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.5",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "MCP stdio adapter for kkAuto API v2 content tools.",
|
|
6
6
|
"repository": {
|
|
@@ -8,6 +8,12 @@
|
|
|
8
8
|
"url": "git+https://github.com/vthuan1889/kk-website.git",
|
|
9
9
|
"directory": "mcp"
|
|
10
10
|
},
|
|
11
|
+
"keywords": [
|
|
12
|
+
"kkauto",
|
|
13
|
+
"facebook",
|
|
14
|
+
"automation",
|
|
15
|
+
"socials"
|
|
16
|
+
],
|
|
11
17
|
"main": "dist/server.js",
|
|
12
18
|
"bin": {
|
|
13
19
|
"kkauto-mcp": "dist/server.js"
|