@respira/wordpress-mcp-server 1.4.1 → 1.4.4
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 +48 -41
- 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 +12 -3
package/README.md
CHANGED
|
@@ -2,11 +2,14 @@
|
|
|
2
2
|
|
|
3
3
|
MCP (Model Context Protocol) server for connecting AI coding assistants to WordPress sites.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
**Important:** This MCP server requires a Respira API key. Get your API key by:
|
|
6
|
+
1. Installing the [Respira WordPress plugin](https://respira.press) on your WordPress site
|
|
7
|
+
2. Going to **Respira → API Keys** in WordPress admin
|
|
8
|
+
3. Generating a new API key
|
|
6
9
|
|
|
7
|
-
|
|
10
|
+
## Installation
|
|
8
11
|
|
|
9
|
-
|
|
12
|
+
Install the MCP server from npm:
|
|
10
13
|
|
|
11
14
|
```bash
|
|
12
15
|
npm install -g @respira/wordpress-mcp-server
|
|
@@ -20,18 +23,6 @@ npx -y @respira/wordpress-mcp-server
|
|
|
20
23
|
|
|
21
24
|
**Note:** When using npx, you don't need to install the package globally. It will automatically download and run the latest version.
|
|
22
25
|
|
|
23
|
-
### From GitHub Releases
|
|
24
|
-
|
|
25
|
-
Since the repository is private, download the MCP server from GitHub releases:
|
|
26
|
-
|
|
27
|
-
1. Go to [GitHub Releases](https://github.com/webmyc/respira-wordpress/releases)
|
|
28
|
-
2. Find the latest release with tag `mcp-v*` (e.g., `mcp-v1.3.1`)
|
|
29
|
-
3. Download the `respira-wordpress-mcp-server-*.zip` file
|
|
30
|
-
4. Extract the archive to a location on your computer (e.g., `~/.respira/mcp-server/`)
|
|
31
|
-
5. The extracted folder contains the `dist/` directory with the compiled server
|
|
32
|
-
|
|
33
|
-
**Note**: The repository is private, so you cannot clone it directly. Use the releases page to download pre-built packages.
|
|
34
|
-
|
|
35
26
|
## Configuration
|
|
36
27
|
|
|
37
28
|
### Option 1: Configuration File (Recommended)
|
|
@@ -98,20 +89,6 @@ If you installed globally with `npm install -g`, use:
|
|
|
98
89
|
}
|
|
99
90
|
```
|
|
100
91
|
|
|
101
|
-
**Option 3: Using local installation**
|
|
102
|
-
|
|
103
|
-
If you downloaded from GitHub releases, add to your Cursor settings (`.cursor/mcp.json`):
|
|
104
|
-
|
|
105
|
-
```json
|
|
106
|
-
{
|
|
107
|
-
"mcpServers": {
|
|
108
|
-
"respira-wordpress": {
|
|
109
|
-
"command": "node",
|
|
110
|
-
"args": ["/path/to/mcp-server/dist/index.js"]
|
|
111
|
-
}
|
|
112
|
-
}
|
|
113
|
-
}
|
|
114
|
-
```
|
|
115
92
|
|
|
116
93
|
### With Claude Desktop
|
|
117
94
|
|
|
@@ -130,18 +107,6 @@ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_
|
|
|
130
107
|
}
|
|
131
108
|
```
|
|
132
109
|
|
|
133
|
-
**Using local installation:**
|
|
134
|
-
|
|
135
|
-
```json
|
|
136
|
-
{
|
|
137
|
-
"mcpServers": {
|
|
138
|
-
"respira-wordpress": {
|
|
139
|
-
"command": "node",
|
|
140
|
-
"args": ["/path/to/mcp-server/dist/index.js"]
|
|
141
|
-
}
|
|
142
|
-
}
|
|
143
|
-
}
|
|
144
|
-
```
|
|
145
110
|
|
|
146
111
|
## Available Tools
|
|
147
112
|
|
|
@@ -158,11 +123,53 @@ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_
|
|
|
158
123
|
- `wordpress_read_post` - Get post content
|
|
159
124
|
- `wordpress_create_post_duplicate` - Duplicate a post
|
|
160
125
|
- `wordpress_list_media` - List media files
|
|
126
|
+
- `wordpress_upload_media` - Upload media files (images, documents, videos) - supports base64, URLs, or file paths
|
|
127
|
+
- `wordpress_get_media` - Get single media item details
|
|
128
|
+
- `wordpress_update_media` - Update media metadata (title, alt text, caption)
|
|
129
|
+
- `wordpress_delete_media` - Delete a media file
|
|
161
130
|
- `wordpress_extract_builder_content` - Extract page builder content
|
|
162
131
|
- `wordpress_inject_builder_content` - Inject page builder content
|
|
163
132
|
- `wordpress_validate_security` - Validate content for security issues
|
|
164
133
|
- `wordpress_switch_site` - Switch between multiple WordPress sites
|
|
165
134
|
|
|
135
|
+
### User Management
|
|
136
|
+
- `wordpress_list_users` - List all users with optional filtering
|
|
137
|
+
- `wordpress_get_user` - Get user details by ID
|
|
138
|
+
- `wordpress_create_user` - Create a new user
|
|
139
|
+
- `wordpress_update_user` - Update user information
|
|
140
|
+
- `wordpress_delete_user` - Delete a user
|
|
141
|
+
|
|
142
|
+
### Comments
|
|
143
|
+
- `wordpress_list_comments` - List all comments with optional filtering
|
|
144
|
+
- `wordpress_get_comment` - Get comment details by ID
|
|
145
|
+
- `wordpress_create_comment` - Create a new comment
|
|
146
|
+
- `wordpress_update_comment` - Update a comment
|
|
147
|
+
- `wordpress_delete_comment` - Delete a comment
|
|
148
|
+
|
|
149
|
+
### Taxonomies
|
|
150
|
+
- `wordpress_list_taxonomies` - List all registered taxonomies
|
|
151
|
+
- `wordpress_get_taxonomy` - Get taxonomy details
|
|
152
|
+
- `wordpress_list_terms` - List terms in a taxonomy
|
|
153
|
+
- `wordpress_get_term` - Get term details
|
|
154
|
+
- `wordpress_create_term` - Create a new term
|
|
155
|
+
- `wordpress_update_term` - Update a term
|
|
156
|
+
- `wordpress_delete_term` - Delete a term
|
|
157
|
+
|
|
158
|
+
### Custom Post Types
|
|
159
|
+
- `wordpress_list_post_types` - List all registered post types
|
|
160
|
+
- `wordpress_get_post_type` - Get post type details
|
|
161
|
+
- `wordpress_list_custom_posts` - List posts of a custom post type
|
|
162
|
+
- `wordpress_get_custom_post` - Get custom post details
|
|
163
|
+
- `wordpress_create_custom_post` - Create a new custom post
|
|
164
|
+
- `wordpress_update_custom_post` - Update a custom post
|
|
165
|
+
- `wordpress_delete_custom_post` - Delete a custom post
|
|
166
|
+
|
|
167
|
+
### WordPress Options
|
|
168
|
+
- `wordpress_list_options` - List WordPress options (with optional search filter)
|
|
169
|
+
- `wordpress_get_option` - Get option value by name
|
|
170
|
+
- `wordpress_update_option` - Update an option value
|
|
171
|
+
- `wordpress_delete_option` - Delete an option
|
|
172
|
+
|
|
166
173
|
### Page Speed Analysis
|
|
167
174
|
- `wordpress_analyze_performance` - Analyze page performance metrics (load time, optimization opportunities)
|
|
168
175
|
- `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"}
|