@respira/wordpress-mcp-server 1.4.0 → 1.4.3
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 +72 -14
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +789 -0
- package/dist/server.js.map +1 -1
- package/dist/types/index.d.ts +59 -0
- package/dist/types/index.d.ts.map +1 -1
- package/dist/wordpress-client.d.ts +127 -1
- package/dist/wordpress-client.d.ts.map +1 -1
- package/dist/wordpress-client.js +207 -6
- package/dist/wordpress-client.js.map +1 -1
- package/package.json +11 -2
package/README.md
CHANGED
|
@@ -4,23 +4,19 @@ MCP (Model Context Protocol) server for connecting AI coding assistants to WordP
|
|
|
4
4
|
|
|
5
5
|
## Installation
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
Install the MCP server from npm:
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
10
|
npm install -g @respira/wordpress-mcp-server
|
|
11
11
|
```
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
Or use it directly with npx (no installation needed):
|
|
14
14
|
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
2. Find the latest release with tag `mcp-v*` (e.g., `mcp-v1.3.1`)
|
|
19
|
-
3. Download the `respira-wordpress-mcp-server-*.zip` file
|
|
20
|
-
4. Extract the archive to a location on your computer (e.g., `~/.respira/mcp-server/`)
|
|
21
|
-
5. The extracted folder contains the `dist/` directory with the compiled server
|
|
15
|
+
```bash
|
|
16
|
+
npx -y @respira/wordpress-mcp-server
|
|
17
|
+
```
|
|
22
18
|
|
|
23
|
-
**Note
|
|
19
|
+
**Note:** When using npx, you don't need to install the package globally. It will automatically download and run the latest version.
|
|
24
20
|
|
|
25
21
|
## Configuration
|
|
26
22
|
|
|
@@ -59,34 +55,54 @@ WP_API_KEY=respira_your-api-key-here
|
|
|
59
55
|
|
|
60
56
|
### With Cursor
|
|
61
57
|
|
|
58
|
+
**Option 1: Using npm (Recommended)**
|
|
59
|
+
|
|
62
60
|
Add to your Cursor settings (`.cursor/mcp.json`):
|
|
63
61
|
|
|
64
62
|
```json
|
|
65
63
|
{
|
|
66
64
|
"mcpServers": {
|
|
67
65
|
"respira-wordpress": {
|
|
68
|
-
"command": "
|
|
69
|
-
"args": ["/
|
|
66
|
+
"command": "npx",
|
|
67
|
+
"args": ["-y", "@respira/wordpress-mcp-server"]
|
|
70
68
|
}
|
|
71
69
|
}
|
|
72
70
|
}
|
|
73
71
|
```
|
|
74
72
|
|
|
73
|
+
**Option 2: Using global installation**
|
|
74
|
+
|
|
75
|
+
If you installed globally with `npm install -g`, use:
|
|
76
|
+
|
|
77
|
+
```json
|
|
78
|
+
{
|
|
79
|
+
"mcpServers": {
|
|
80
|
+
"respira-wordpress": {
|
|
81
|
+
"command": "respira-wordpress-mcp"
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
|
|
75
88
|
### With Claude Desktop
|
|
76
89
|
|
|
77
90
|
Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
|
|
78
91
|
|
|
92
|
+
**Using npm (Recommended):**
|
|
93
|
+
|
|
79
94
|
```json
|
|
80
95
|
{
|
|
81
96
|
"mcpServers": {
|
|
82
97
|
"respira-wordpress": {
|
|
83
|
-
"command": "
|
|
84
|
-
"args": ["/
|
|
98
|
+
"command": "npx",
|
|
99
|
+
"args": ["-y", "@respira/wordpress-mcp-server"]
|
|
85
100
|
}
|
|
86
101
|
}
|
|
87
102
|
}
|
|
88
103
|
```
|
|
89
104
|
|
|
105
|
+
|
|
90
106
|
## Available Tools
|
|
91
107
|
|
|
92
108
|
### Content Management
|
|
@@ -102,11 +118,53 @@ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_
|
|
|
102
118
|
- `wordpress_read_post` - Get post content
|
|
103
119
|
- `wordpress_create_post_duplicate` - Duplicate a post
|
|
104
120
|
- `wordpress_list_media` - List media files
|
|
121
|
+
- `wordpress_upload_media` - Upload media files (images, documents, videos) - supports base64, URLs, or file paths
|
|
122
|
+
- `wordpress_get_media` - Get single media item details
|
|
123
|
+
- `wordpress_update_media` - Update media metadata (title, alt text, caption)
|
|
124
|
+
- `wordpress_delete_media` - Delete a media file
|
|
105
125
|
- `wordpress_extract_builder_content` - Extract page builder content
|
|
106
126
|
- `wordpress_inject_builder_content` - Inject page builder content
|
|
107
127
|
- `wordpress_validate_security` - Validate content for security issues
|
|
108
128
|
- `wordpress_switch_site` - Switch between multiple WordPress sites
|
|
109
129
|
|
|
130
|
+
### User Management
|
|
131
|
+
- `wordpress_list_users` - List all users with optional filtering
|
|
132
|
+
- `wordpress_get_user` - Get user details by ID
|
|
133
|
+
- `wordpress_create_user` - Create a new user
|
|
134
|
+
- `wordpress_update_user` - Update user information
|
|
135
|
+
- `wordpress_delete_user` - Delete a user
|
|
136
|
+
|
|
137
|
+
### Comments
|
|
138
|
+
- `wordpress_list_comments` - List all comments with optional filtering
|
|
139
|
+
- `wordpress_get_comment` - Get comment details by ID
|
|
140
|
+
- `wordpress_create_comment` - Create a new comment
|
|
141
|
+
- `wordpress_update_comment` - Update a comment
|
|
142
|
+
- `wordpress_delete_comment` - Delete a comment
|
|
143
|
+
|
|
144
|
+
### Taxonomies
|
|
145
|
+
- `wordpress_list_taxonomies` - List all registered taxonomies
|
|
146
|
+
- `wordpress_get_taxonomy` - Get taxonomy details
|
|
147
|
+
- `wordpress_list_terms` - List terms in a taxonomy
|
|
148
|
+
- `wordpress_get_term` - Get term details
|
|
149
|
+
- `wordpress_create_term` - Create a new term
|
|
150
|
+
- `wordpress_update_term` - Update a term
|
|
151
|
+
- `wordpress_delete_term` - Delete a term
|
|
152
|
+
|
|
153
|
+
### Custom Post Types
|
|
154
|
+
- `wordpress_list_post_types` - List all registered post types
|
|
155
|
+
- `wordpress_get_post_type` - Get post type details
|
|
156
|
+
- `wordpress_list_custom_posts` - List posts of a custom post type
|
|
157
|
+
- `wordpress_get_custom_post` - Get custom post details
|
|
158
|
+
- `wordpress_create_custom_post` - Create a new custom post
|
|
159
|
+
- `wordpress_update_custom_post` - Update a custom post
|
|
160
|
+
- `wordpress_delete_custom_post` - Delete a custom post
|
|
161
|
+
|
|
162
|
+
### WordPress Options
|
|
163
|
+
- `wordpress_list_options` - List WordPress options (with optional search filter)
|
|
164
|
+
- `wordpress_get_option` - Get option value by name
|
|
165
|
+
- `wordpress_update_option` - Update an option value
|
|
166
|
+
- `wordpress_delete_option` - Delete an option
|
|
167
|
+
|
|
110
168
|
### Page Speed Analysis
|
|
111
169
|
- `wordpress_analyze_performance` - Analyze page performance metrics (load time, optimization opportunities)
|
|
112
170
|
- `wordpress_get_core_web_vitals` - Get Core Web Vitals scores (LCP, FID, CLS)
|
package/dist/server.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,KAAK,CAA2C;gBAE5C,WAAW,EAAE,mBAAmB,EAAE;IA2B9C,OAAO,CAAC,aAAa;IA0CrB,OAAO,CAAC,QAAQ;
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,KAAK,CAA2C;gBAE5C,WAAW,EAAE,mBAAmB,EAAE;IA2B9C,OAAO,CAAC,aAAa;IA0CrB,OAAO,CAAC,QAAQ;YAyuCF,cAAc;IA2QtB,GAAG;CAKV"}
|