@wezzard/mcp-x-articles 0.0.0-stage → 0.2.0
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/.claude-plugin/marketplace.json +14 -0
- package/.claude-plugin/plugin.json +18 -0
- package/.codex-plugin/mcp.json +11 -0
- package/.codex-plugin/plugin.json +31 -0
- package/.cursor-plugin/plugin.json +39 -0
- package/.mcp.json +11 -0
- package/LICENSE +21 -0
- package/README.md +134 -2
- package/assets/logo.svg +11 -0
- package/dist/server.mjs +20335 -0
- package/mcp_config.json +27 -0
- package/package.json +73 -4
- package/pi-mcp.json +1 -0
- package/plugin.json +17 -0
- package/skills/x-articles/SKILL.md +15 -0
package/mcp_config.json
ADDED
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
{
|
|
2
|
+
"mcpServers": {
|
|
3
|
+
"mcp-x-articles": {
|
|
4
|
+
"command": "node",
|
|
5
|
+
"args": [
|
|
6
|
+
"dist/server.mjs"
|
|
7
|
+
],
|
|
8
|
+
"cwd": ".",
|
|
9
|
+
"env": {
|
|
10
|
+
"X_OAUTH_CONSUMER_KEY": "${X_OAUTH_CONSUMER_KEY}",
|
|
11
|
+
"X_OAUTH_CONSUMER_SECRET": "${X_OAUTH_CONSUMER_SECRET}"
|
|
12
|
+
},
|
|
13
|
+
"variables": [
|
|
14
|
+
{
|
|
15
|
+
"name": "X_OAUTH_CONSUMER_KEY",
|
|
16
|
+
"title": "X OAuth Consumer Key (Optional — leave blank to use Browser Setup / macOS Keychain)",
|
|
17
|
+
"description": "API Key (Consumer Key) from https://console.x.com -> Apps -> Keys and tokens."
|
|
18
|
+
},
|
|
19
|
+
{
|
|
20
|
+
"name": "X_OAUTH_CONSUMER_SECRET",
|
|
21
|
+
"title": "X OAuth Consumer Secret (Optional — leave blank to use Browser Setup / macOS Keychain)",
|
|
22
|
+
"description": "API Key Secret (Consumer Secret) from https://console.x.com -> Apps -> Keys and tokens."
|
|
23
|
+
}
|
|
24
|
+
]
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,75 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@wezzard/mcp-x-articles",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"description": "
|
|
6
|
-
|
|
3
|
+
"version": "0.2.0",
|
|
4
|
+
"type": "module",
|
|
5
|
+
"description": "MCP server and multi-agent plugin for publishing Markdown files as X Articles via the official X API v2 Articles endpoints: deterministic Markdown conversion, zero-token media upload, macOS Keychain secret storage, and two-step human review.",
|
|
6
|
+
"license": "MIT",
|
|
7
|
+
"author": {
|
|
8
|
+
"name": "WeZZard",
|
|
9
|
+
"url": "https://github.com/WeZZard"
|
|
10
|
+
},
|
|
11
|
+
"repository": {
|
|
12
|
+
"type": "git",
|
|
13
|
+
"url": "git+https://github.com/WeZZard/mcp-x-articles.git"
|
|
14
|
+
},
|
|
15
|
+
"homepage": "https://github.com/WeZZard/mcp-x-articles#readme",
|
|
16
|
+
"bugs": {
|
|
17
|
+
"url": "https://github.com/WeZZard/mcp-x-articles/issues"
|
|
18
|
+
},
|
|
19
|
+
"keywords": [
|
|
20
|
+
"pi-package",
|
|
21
|
+
"mcp",
|
|
22
|
+
"mcp-server",
|
|
23
|
+
"claude-code",
|
|
24
|
+
"codex",
|
|
25
|
+
"cursor",
|
|
26
|
+
"antigravity",
|
|
27
|
+
"x",
|
|
28
|
+
"twitter",
|
|
29
|
+
"articles",
|
|
30
|
+
"markdown"
|
|
31
|
+
],
|
|
32
|
+
"publishConfig": {
|
|
33
|
+
"access": "public"
|
|
34
|
+
},
|
|
35
|
+
"bin": {
|
|
36
|
+
"mcp-x-articles": "dist/server.mjs"
|
|
37
|
+
},
|
|
38
|
+
"files": [
|
|
39
|
+
"dist/",
|
|
40
|
+
"skills/",
|
|
41
|
+
"assets/",
|
|
42
|
+
"README.md",
|
|
43
|
+
"LICENSE",
|
|
44
|
+
"plugin.json",
|
|
45
|
+
"mcp_config.json",
|
|
46
|
+
"pi-mcp.json",
|
|
47
|
+
".mcp.json",
|
|
48
|
+
".claude-plugin/",
|
|
49
|
+
".codex-plugin/",
|
|
50
|
+
".cursor-plugin/"
|
|
51
|
+
],
|
|
52
|
+
"pi": {
|
|
53
|
+
"mcp": "./pi-mcp.json",
|
|
54
|
+
"skills": [
|
|
55
|
+
"./skills"
|
|
56
|
+
]
|
|
57
|
+
},
|
|
58
|
+
"scripts": {
|
|
59
|
+
"build": "node scripts/build.mjs",
|
|
60
|
+
"typecheck": "tsc --noEmit",
|
|
61
|
+
"test": "node test/run-tests.mjs",
|
|
62
|
+
"verify:package": "node scripts/verify-package.mjs",
|
|
63
|
+
"check": "npm run build && npm run typecheck && npm test && npm run verify:package"
|
|
64
|
+
},
|
|
65
|
+
"engines": {
|
|
66
|
+
"node": ">=20"
|
|
67
|
+
},
|
|
68
|
+
"devDependencies": {
|
|
69
|
+
"@modelcontextprotocol/sdk": "^1.27.1",
|
|
70
|
+
"@types/node": "^22.13.10",
|
|
71
|
+
"esbuild": "^0.25.1",
|
|
72
|
+
"marked": "^18.0.7",
|
|
73
|
+
"typescript": "^5.8.2"
|
|
74
|
+
}
|
|
75
|
+
}
|
package/pi-mcp.json
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"mcpServers":{"x-articles":{"command":"npx","args":["-y","@wezzard/mcp-x-articles@0.2.0"],"lifecycle":"lazy","directTools":true,"toolPrefix":"none"}}}
|
package/plugin.json
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "mcp-x-articles",
|
|
3
|
+
"displayName": "X Articles",
|
|
4
|
+
"version": "0.2.0",
|
|
5
|
+
"description": "Publish Markdown files as X Articles via official X API v2: deterministic conversion, zero-token image upload, macOS Keychain secret storage, and two-step human review.",
|
|
6
|
+
"logo": "assets/logo.svg",
|
|
7
|
+
"author": {
|
|
8
|
+
"name": "WeZZard",
|
|
9
|
+
"url": "https://github.com/WeZZard"
|
|
10
|
+
},
|
|
11
|
+
"repository": "https://github.com/WeZZard/mcp-x-articles",
|
|
12
|
+
"suggestedPrompts": [
|
|
13
|
+
"Publish index.md as an X Article draft",
|
|
14
|
+
"Run X Article preflight on my Markdown post and check images",
|
|
15
|
+
"Publish zh-Hans/index.md with its cover image as an X Article draft"
|
|
16
|
+
]
|
|
17
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: x-articles
|
|
3
|
+
description: Publish a local Markdown file as an X Article via @wezzard/mcp-x-articles and the official X API v2 Articles endpoints.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# x-articles
|
|
7
|
+
|
|
8
|
+
Publish a Markdown file as an X Article through the `@wezzard/mcp-x-articles` MCP tools.
|
|
9
|
+
|
|
10
|
+
1. Call `x_article_auth_status` if authentication is unverified; if credentials or user tokens are missing, call `x_article_auth_status({ login: true })` to open the local browser setup card (which saves X API keys directly to macOS Keychain and completes X OAuth 1.0a consent without exposing secrets to chat).
|
|
11
|
+
2. Call `x_article_preflight({ markdown_path, cover_image_path })` first, and visually inspect every image in `images_for_visual_review` for live credentials, financial balances, account IDs, email addresses, real names, or private file paths.
|
|
12
|
+
3. **Checkpoint 1:** Whenever preflight reports text `findings`, visual sensitivities, or conversion `warnings`, ask the user with your dedicated ask-user-question tool (or directly in conversation) to rule on each item before uploading anything to X.
|
|
13
|
+
4. Call `x_article_create_draft({ markdown_path, preflight_token, cover_image_path })` and share the returned `editor_url` (`https://x.com/compose/articles/edit/<article_id>`).
|
|
14
|
+
5. **Checkpoint 2:** Stop after creating the draft, and ask the user with your dedicated ask-user-question tool (or directly in conversation) for explicit approval before calling `x_article_publish({ article_id })`.
|
|
15
|
+
6. Respect X API limits: the Articles API provides no update endpoint and no delete endpoint, so any post-draft edits either happen in the X web composer or create a fresh draft.
|