claudaborative-editing 0.1.0 → 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/README.md +41 -11
- package/dist/index.js +4177 -547
- package/dist/index.js.map +1 -1
- package/package.json +37 -4
package/README.md
CHANGED
|
@@ -8,22 +8,34 @@ An MCP server that lets Claude Code collaboratively edit WordPress posts in real
|
|
|
8
8
|
npx claudaborative-editing setup
|
|
9
9
|
```
|
|
10
10
|
|
|
11
|
-
The setup wizard
|
|
11
|
+
The setup wizard will:
|
|
12
12
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
13
|
+
1. Open your browser to authorize with your WordPress site (creates an Application Password automatically)
|
|
14
|
+
2. Auto-detect installed MCP clients (Claude Code, Claude Desktop, VS Code, Cursor, Windsurf)
|
|
15
|
+
3. Write the MCP server config directly to each client's settings file
|
|
16
|
+
|
|
17
|
+
That's it — no manual config editing required.
|
|
16
18
|
|
|
17
19
|
## Prerequisites
|
|
18
20
|
|
|
19
21
|
- **WordPress 7.0+** with collaborative editing enabled (Settings → Writing)
|
|
20
|
-
-
|
|
21
|
-
- In WordPress admin: Users → Your Profile → Application Passwords
|
|
22
|
-
- Enter a name (e.g., "Claude Code"), click **Add New**, copy the password
|
|
22
|
+
- A WordPress user with `edit_posts` capability
|
|
23
23
|
|
|
24
24
|
## Configuration
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
### Setup options
|
|
27
|
+
|
|
28
|
+
| Flag | Description |
|
|
29
|
+
| ----------------- | ----------------------------------------------------- |
|
|
30
|
+
| `--manual` | Skip browser auth, prompt for credentials manually |
|
|
31
|
+
| `--remove` | Remove claudaborative-editing config from MCP clients |
|
|
32
|
+
| `--client <name>` | Configure a specific client only |
|
|
33
|
+
|
|
34
|
+
Supported `--client` values: `claude-code`, `claude-desktop`, `vscode`, `vscode-insiders`, `cursor`, `windsurf`.
|
|
35
|
+
|
|
36
|
+
### Manual configuration
|
|
37
|
+
|
|
38
|
+
If you prefer not to use the setup wizard, you can pass credentials as environment variables. Use the `wp_connect` MCP tool to connect at runtime, or configure your MCP client manually with these variables:
|
|
27
39
|
|
|
28
40
|
| Variable | Description |
|
|
29
41
|
| ----------------- | ------------------------------ |
|
|
@@ -66,6 +78,22 @@ Credentials are passed as environment variables via the `claude mcp add` command
|
|
|
66
78
|
| `wp_replace_blocks` | Replace a range of blocks with new ones |
|
|
67
79
|
| `wp_set_title` | Update the post title |
|
|
68
80
|
|
|
81
|
+
### Post Metadata
|
|
82
|
+
|
|
83
|
+
| Tool | Description |
|
|
84
|
+
| ----------------------- | ------------------------------------------------------ |
|
|
85
|
+
| `wp_list_categories` | List existing categories (with optional search) |
|
|
86
|
+
| `wp_list_tags` | List existing tags (with optional search) |
|
|
87
|
+
| `wp_set_status` | Change publication status (draft, pending, publish, …) |
|
|
88
|
+
| `wp_set_categories` | Set categories by name (creates if needed) |
|
|
89
|
+
| `wp_set_tags` | Set tags by name (creates if needed) |
|
|
90
|
+
| `wp_set_excerpt` | Set or clear the post excerpt |
|
|
91
|
+
| `wp_set_featured_image` | Set featured image by attachment ID (0 to remove) |
|
|
92
|
+
| `wp_set_date` | Set publication date (ISO 8601) |
|
|
93
|
+
| `wp_set_slug` | Set URL slug |
|
|
94
|
+
| `wp_set_sticky` | Pin/unpin post on front page |
|
|
95
|
+
| `wp_set_comment_status` | Enable/disable comments |
|
|
96
|
+
|
|
69
97
|
### Status
|
|
70
98
|
|
|
71
99
|
| Tool | Description |
|
|
@@ -80,11 +108,13 @@ Credentials are passed as environment variables via the `claude mcp add` command
|
|
|
80
108
|
1. wp_connect → Connect to your WordPress site
|
|
81
109
|
2. wp_list_posts → See available posts
|
|
82
110
|
3. wp_open_post(postId: 42) → Open post for editing
|
|
83
|
-
4. wp_read_post → See
|
|
111
|
+
4. wp_read_post → See current content and metadata
|
|
84
112
|
5. wp_update_block(index: "1", content: "Updated paragraph text") → Edit a block
|
|
85
113
|
6. wp_insert_block(position: 2, name: "core/heading", content: "New Section", attributes: {level: 3})
|
|
86
|
-
7.
|
|
87
|
-
8.
|
|
114
|
+
7. wp_set_categories(categories: ["Tech", "Tutorial"]) → Assign categories
|
|
115
|
+
8. wp_set_excerpt(excerpt: "A quick intro to widgets") → Set excerpt
|
|
116
|
+
9. wp_set_status(status: "publish") → Publish the post
|
|
117
|
+
10. wp_disconnect → Done
|
|
88
118
|
```
|
|
89
119
|
|
|
90
120
|
## How It Works
|