@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 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
- ### From npm (Coming Soon)
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
- ### From GitHub Releases
13
+ Or use it directly with npx (no installation needed):
14
14
 
15
- Since the repository is private, download the MCP server from GitHub releases:
16
-
17
- 1. Go to [GitHub Releases](https://github.com/webmyc/respira-wordpress/releases)
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**: The repository is private, so you cannot clone it directly. Use the releases page to download pre-built packages.
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": "node",
69
- "args": ["/path/to/mcp-server/dist/index.js"]
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": "node",
84
- "args": ["/path/to/mcp-server/dist/index.js"]
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)
@@ -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;YA4hBF,cAAc;IAsJtB,GAAG;CAKV"}
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"}