@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 CHANGED
@@ -1,8 +1,10 @@
1
1
  # kkAuto MCP Adapter
2
2
 
3
- Local stdio MCP server for kkAuto API v2 content tools. It exposes a thin tool layer over existing `/api/v2/*` routes and never writes directly to the database.
3
+ `@kkauto/kkauto-mcp` connects MCP-compatible AI clients to kkAuto automation services at `https://kkauto.net`.
4
4
 
5
- This package is the MCP bridge for `kkauto.net` social-media automation services and compatible tenant/selfhost kkAuto deployments. It lets AI clients operate tenant-scoped kkAuto workflows for source-post intake, source workflow claiming, source crawler management, and Facebook post operations through the existing API v2 surface instead of custom direct integrations.
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.3` after publish, or a local checkout for development.
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.3`, so MCP clients can run it with `npx` without copying the website repository after publish:
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.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",
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"