@kkauto/kkauto-mcp 0.3.3 → 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 +6 -46
- package/dist/server.js +1 -1
- package/package.json +12 -1
package/README.md
CHANGED
|
@@ -1,8 +1,10 @@
|
|
|
1
1
|
# kkAuto MCP Adapter
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
`@kkauto/kkauto-mcp` connects MCP-compatible AI clients to kkAuto automation services at `https://kkauto.net`.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
It runs as a local stdio MCP server and turns AI tool calls into authenticated kkAuto API v2 requests. Use it to operate tenant-scoped social-media automation workflows from AI clients, including source-post intake, source workflow claiming, source crawler management, and Facebook post operations.
|
|
6
|
+
|
|
7
|
+
The adapter stays thin by design: it uses the same `/api/v2/*` routes as normal kkAuto clients, works with compatible tenant/selfhost deployments, and never writes directly to the database.
|
|
6
8
|
|
|
7
9
|
## Supported Scope
|
|
8
10
|
|
|
@@ -17,11 +19,11 @@ This package is the MCP bridge for `kkauto.net` social-media automation services
|
|
|
17
19
|
- Node.js 20 or newer.
|
|
18
20
|
- Active kkAuto API token from `/wtadmin/mcp` or `/wtadmin/token?type=api`.
|
|
19
21
|
- Tenant-aware base URL for SaaS, or the selfhost app base URL.
|
|
20
|
-
- 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.
|
|
21
23
|
|
|
22
24
|
## Client Setup With npx
|
|
23
25
|
|
|
24
|
-
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:
|
|
25
27
|
|
|
26
28
|
Recommended setup:
|
|
27
29
|
|
|
@@ -105,48 +107,6 @@ Selfhost can use the local app URL as `KK_API_BASE_URL`, for example `https://kk
|
|
|
105
107
|
|
|
106
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.
|
|
107
109
|
|
|
108
|
-
## Package Release
|
|
109
|
-
|
|
110
|
-
Prepared package release:
|
|
111
|
-
|
|
112
|
-
- Name: `@kkauto/kkauto-mcp`
|
|
113
|
-
- Version: `0.3.3`
|
|
114
|
-
- Binary: `kkauto-mcp -> dist/server.js`
|
|
115
|
-
- Expected tarball after publish: `https://registry.npmjs.org/@kkauto/kkauto-mcp/-/kkauto-mcp-0.3.3.tgz`
|
|
116
|
-
|
|
117
|
-
Package settings:
|
|
118
|
-
|
|
119
|
-
- CLI binary: `kkauto-mcp`
|
|
120
|
-
- Published files: `dist`, `README.md`, `package.json`
|
|
121
|
-
- `prepack` runs `npm run build`
|
|
122
|
-
|
|
123
|
-
Verify published metadata:
|
|
124
|
-
|
|
125
|
-
```bash
|
|
126
|
-
npm view @kkauto/kkauto-mcp version
|
|
127
|
-
npm view @kkauto/kkauto-mcp bin dist.tarball
|
|
128
|
-
```
|
|
129
|
-
|
|
130
|
-
Publish the prepared `0.3.3` scoped release:
|
|
131
|
-
|
|
132
|
-
```bash
|
|
133
|
-
cd mcp
|
|
134
|
-
npm install
|
|
135
|
-
npm test
|
|
136
|
-
npm pack --dry-run
|
|
137
|
-
npm publish --access public
|
|
138
|
-
```
|
|
139
|
-
|
|
140
|
-
After the scoped package is published and verified, deprecate the old unscoped package while keeping it installable:
|
|
141
|
-
|
|
142
|
-
```bash
|
|
143
|
-
npm deprecate kkauto-mcp@"<=0.3.2" "Package moved to @kkauto/kkauto-mcp. Use: npx -y @kkauto/kkauto-mcp"
|
|
144
|
-
```
|
|
145
|
-
|
|
146
|
-
For the next release after `0.3.3`, bump the package version first, then publish.
|
|
147
|
-
|
|
148
|
-
Use `npm publish --registry <private-registry-url>` for a private registry.
|
|
149
|
-
|
|
150
110
|
## Tools
|
|
151
111
|
|
|
152
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,8 +1,19 @@
|
|
|
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
|
+
"repository": {
|
|
7
|
+
"type": "git",
|
|
8
|
+
"url": "git+https://github.com/vthuan1889/kk-website.git",
|
|
9
|
+
"directory": "mcp"
|
|
10
|
+
},
|
|
11
|
+
"keywords": [
|
|
12
|
+
"kkauto",
|
|
13
|
+
"facebook",
|
|
14
|
+
"automation",
|
|
15
|
+
"socials"
|
|
16
|
+
],
|
|
6
17
|
"main": "dist/server.js",
|
|
7
18
|
"bin": {
|
|
8
19
|
"kkauto-mcp": "dist/server.js"
|