mcp-wordpress 1.2.2 → 1.2.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 +104 -8
- package/docs/DOCKER.md +13 -13
- package/docs/developer/MAINTENANCE.md +2 -2
- package/package.json +9 -4
package/README.md
CHANGED
|
@@ -7,9 +7,9 @@
|
|
|
7
7
|
A comprehensive Model Context Protocol (MCP) server for WordPress management through the WordPress REST API v2. Completely written in TypeScript with modular architecture and 95%+ test coverage.
|
|
8
8
|
|
|
9
9
|
[](https://www.npmjs.com/package/mcp-wordpress)
|
|
10
|
-
[](https://github.com/
|
|
11
|
-
[](https://github.com/
|
|
12
|
-
[](https://github.com/
|
|
10
|
+
[](https://github.com/docdyhr/mcp-wordpress)
|
|
11
|
+
[](https://github.com/docdyhr/mcp-wordpress)
|
|
12
|
+
[](https://github.com/docdyhr/mcp-wordpress/blob/main/REFACTORING.md)
|
|
13
13
|
|
|
14
14
|
## 🚀 Features
|
|
15
15
|
|
|
@@ -46,7 +46,7 @@ mcp-wordpress
|
|
|
46
46
|
### Option 2: Local Development
|
|
47
47
|
|
|
48
48
|
```bash
|
|
49
|
-
git clone https://github.com/
|
|
49
|
+
git clone https://github.com/docdyhr/mcp-wordpress.git
|
|
50
50
|
cd mcp-wordpress
|
|
51
51
|
npm install
|
|
52
52
|
npm run setup
|
|
@@ -174,7 +174,7 @@ I want to use the NPX version (mcp-wordpress) so I don't need to install anythin
|
|
|
174
174
|
For local development and customization:
|
|
175
175
|
|
|
176
176
|
```text
|
|
177
|
-
Build and configure the MCP WordPress server project from https://github.com/
|
|
177
|
+
Build and configure the MCP WordPress server project from https://github.com/docdyhr/mcp-wordpress locally on my computer.
|
|
178
178
|
|
|
179
179
|
Please:
|
|
180
180
|
1. Clone the repository to an appropriate directory
|
|
@@ -790,10 +790,10 @@ docker run -d \
|
|
|
790
790
|
-e WORDPRESS_SITE_URL=https://your-site.com \
|
|
791
791
|
-e WORDPRESS_USERNAME=your-username \
|
|
792
792
|
-e WORDPRESS_APP_PASSWORD=your-app-password \
|
|
793
|
-
|
|
793
|
+
docdyhr/mcp-wordpress:latest
|
|
794
794
|
|
|
795
795
|
# Using Docker Compose
|
|
796
|
-
curl -O https://raw.githubusercontent.com/
|
|
796
|
+
curl -O https://raw.githubusercontent.com/docdyhr/mcp-wordpress/main/docker-compose.yml
|
|
797
797
|
docker-compose up -d
|
|
798
798
|
```
|
|
799
799
|
|
|
@@ -803,7 +803,7 @@ docker-compose up -d
|
|
|
803
803
|
version: '3.8'
|
|
804
804
|
services:
|
|
805
805
|
mcp-wordpress:
|
|
806
|
-
image:
|
|
806
|
+
image: docdyhr/mcp-wordpress:latest
|
|
807
807
|
restart: unless-stopped
|
|
808
808
|
environment:
|
|
809
809
|
- WORDPRESS_SITE_URL=https://your-site.com
|
|
@@ -888,3 +888,99 @@ npm run test:contracts
|
|
|
888
888
|
- One-command deployment to any Docker environment
|
|
889
889
|
|
|
890
890
|
**📚 Read the full release notes for all details!**
|
|
891
|
+
|
|
892
|
+
## 🚀 Release & Publishing
|
|
893
|
+
|
|
894
|
+
This project uses automated semantic versioning and publishing to NPM and Docker Hub.
|
|
895
|
+
|
|
896
|
+
### 📦 Installation Options
|
|
897
|
+
|
|
898
|
+
**NPM Package:**
|
|
899
|
+
|
|
900
|
+
```bash
|
|
901
|
+
# Latest stable version
|
|
902
|
+
npm install -g mcp-wordpress
|
|
903
|
+
|
|
904
|
+
# Specific version
|
|
905
|
+
npm install -g mcp-wordpress@1.2.2
|
|
906
|
+
|
|
907
|
+
# Use with npx (no installation)
|
|
908
|
+
npx mcp-wordpress
|
|
909
|
+
```
|
|
910
|
+
|
|
911
|
+
**Docker Images:**
|
|
912
|
+
|
|
913
|
+
```bash
|
|
914
|
+
# Latest stable version
|
|
915
|
+
docker pull docdyhr/mcp-wordpress:latest
|
|
916
|
+
|
|
917
|
+
# Specific version
|
|
918
|
+
docker pull docdyhr/mcp-wordpress:1.2.2
|
|
919
|
+
|
|
920
|
+
# Run directly
|
|
921
|
+
docker run -d docdyhr/mcp-wordpress:latest
|
|
922
|
+
```
|
|
923
|
+
|
|
924
|
+
### 🏷️ Release Process
|
|
925
|
+
|
|
926
|
+
**Automated Releases:**
|
|
927
|
+
|
|
928
|
+
- Releases are automatically created when conventional commits are pushed to the `main` branch
|
|
929
|
+
- Semantic versioning determines the version bump automatically
|
|
930
|
+
- NPM and Docker Hub publishing happens automatically on release
|
|
931
|
+
|
|
932
|
+
**Conventional Commit Format:**
|
|
933
|
+
|
|
934
|
+
```bash
|
|
935
|
+
# Patch release (1.2.2 → 1.2.3)
|
|
936
|
+
fix: resolve authentication timeout issue
|
|
937
|
+
|
|
938
|
+
# Minor release (1.2.2 → 1.3.0)
|
|
939
|
+
feat: add new performance monitoring tools
|
|
940
|
+
|
|
941
|
+
# Major release (1.2.2 → 2.0.0)
|
|
942
|
+
feat!: redesign MCP tool interface
|
|
943
|
+
BREAKING CHANGE: tool parameter structure has changed
|
|
944
|
+
```
|
|
945
|
+
|
|
946
|
+
**Manual Release (if needed):**
|
|
947
|
+
|
|
948
|
+
```bash
|
|
949
|
+
# Test release locally
|
|
950
|
+
npm run release:dry
|
|
951
|
+
|
|
952
|
+
# Create release manually (requires proper permissions)
|
|
953
|
+
npm run release
|
|
954
|
+
```
|
|
955
|
+
|
|
956
|
+
### 📋 Release Checklist
|
|
957
|
+
|
|
958
|
+
For contributors planning releases:
|
|
959
|
+
|
|
960
|
+
1. **Pre-Release Validation:**
|
|
961
|
+
- ✅ All tests passing (`npm test`)
|
|
962
|
+
- ✅ Documentation updated
|
|
963
|
+
- ✅ Performance benchmarks within acceptable range
|
|
964
|
+
- ✅ Security audit clean (`npm audit`)
|
|
965
|
+
|
|
966
|
+
2. **Commit with Conventional Format:**
|
|
967
|
+
|
|
968
|
+
```bash
|
|
969
|
+
git add .
|
|
970
|
+
git commit -m "feat: add new functionality"
|
|
971
|
+
git push origin main
|
|
972
|
+
```
|
|
973
|
+
|
|
974
|
+
3. **Automated Process Handles:**
|
|
975
|
+
- 📝 Generate release notes
|
|
976
|
+
- 🏷️ Create GitHub release
|
|
977
|
+
- 📦 Publish to NPM with provenance
|
|
978
|
+
- 🐳 Build and push Docker images (multi-arch)
|
|
979
|
+
- 📚 Update CHANGELOG.md
|
|
980
|
+
- 🔗 Update Docker Hub description
|
|
981
|
+
|
|
982
|
+
### 🌍 Distribution Channels
|
|
983
|
+
|
|
984
|
+
- **NPM:** [`mcp-wordpress`](https://www.npmjs.com/package/mcp-wordpress)
|
|
985
|
+
- **Docker Hub:** [`docdyhr/mcp-wordpress`](https://hub.docker.com/r/docdyhr/mcp-wordpress)
|
|
986
|
+
- **GitHub Releases:** [Latest releases](https://github.com/docdyhr/mcp-wordpress/releases)
|
package/docs/DOCKER.md
CHANGED
|
@@ -18,14 +18,14 @@ docker run -d \
|
|
|
18
18
|
-e WORDPRESS_SITE_URL=https://your-site.com \
|
|
19
19
|
-e WORDPRESS_USERNAME=your-username \
|
|
20
20
|
-e WORDPRESS_APP_PASSWORD=your-app-password \
|
|
21
|
-
|
|
21
|
+
docdyhr/mcp-wordpress:latest
|
|
22
22
|
```
|
|
23
23
|
|
|
24
24
|
### Option 2: Docker Compose
|
|
25
25
|
|
|
26
26
|
```bash
|
|
27
27
|
# Download the compose file
|
|
28
|
-
curl -O https://raw.githubusercontent.com/
|
|
28
|
+
curl -O https://raw.githubusercontent.com/docdyhr/mcp-wordpress/main/docker-compose.yml
|
|
29
29
|
|
|
30
30
|
# Configure environment variables (see below)
|
|
31
31
|
# Start the service
|
|
@@ -36,7 +36,7 @@ docker-compose up -d
|
|
|
36
36
|
|
|
37
37
|
```bash
|
|
38
38
|
# Clone the repository
|
|
39
|
-
git clone https://github.com/
|
|
39
|
+
git clone https://github.com/docdyhr/mcp-wordpress.git
|
|
40
40
|
cd mcp-wordpress
|
|
41
41
|
|
|
42
42
|
# Build the image
|
|
@@ -68,7 +68,7 @@ For multi-site setups, mount a configuration file:
|
|
|
68
68
|
docker run -d \
|
|
69
69
|
--name mcp-wordpress \
|
|
70
70
|
-v ./mcp-wordpress.config.json:/app/config/mcp-wordpress.config.json:ro \
|
|
71
|
-
|
|
71
|
+
docdyhr/mcp-wordpress:latest
|
|
72
72
|
```
|
|
73
73
|
|
|
74
74
|
**Example `mcp-wordpress.config.json`:**
|
|
@@ -107,7 +107,7 @@ version: '3.8'
|
|
|
107
107
|
|
|
108
108
|
services:
|
|
109
109
|
mcp-wordpress:
|
|
110
|
-
image:
|
|
110
|
+
image: docdyhr/mcp-wordpress:latest
|
|
111
111
|
container_name: mcp-wordpress
|
|
112
112
|
restart: unless-stopped
|
|
113
113
|
environment:
|
|
@@ -153,7 +153,7 @@ version: '3.8'
|
|
|
153
153
|
|
|
154
154
|
services:
|
|
155
155
|
mcp-wordpress:
|
|
156
|
-
image:
|
|
156
|
+
image: docdyhr/mcp-wordpress:latest
|
|
157
157
|
deploy:
|
|
158
158
|
replicas: 2
|
|
159
159
|
restart_policy:
|
|
@@ -201,7 +201,7 @@ spec:
|
|
|
201
201
|
spec:
|
|
202
202
|
containers:
|
|
203
203
|
- name: mcp-wordpress
|
|
204
|
-
image:
|
|
204
|
+
image: docdyhr/mcp-wordpress:latest
|
|
205
205
|
ports:
|
|
206
206
|
- containerPort: 3000
|
|
207
207
|
env:
|
|
@@ -262,7 +262,7 @@ docker inspect --format='{{.State.Health.Status}}' mcp-wordpress
|
|
|
262
262
|
docker exec -it mcp-wordpress /bin/sh
|
|
263
263
|
|
|
264
264
|
# Update to latest version
|
|
265
|
-
docker pull
|
|
265
|
+
docker pull docdyhr/mcp-wordpress:latest
|
|
266
266
|
docker stop mcp-wordpress
|
|
267
267
|
docker rm mcp-wordpress
|
|
268
268
|
# Run with new image...
|
|
@@ -354,7 +354,7 @@ echo \"your-app-password\" | docker secret create wordpress_password -
|
|
|
354
354
|
version: '3.8'
|
|
355
355
|
services:
|
|
356
356
|
mcp-wordpress:
|
|
357
|
-
image:
|
|
357
|
+
image: docdyhr/mcp-wordpress:latest
|
|
358
358
|
secrets:
|
|
359
359
|
- wordpress_url
|
|
360
360
|
- wordpress_user
|
|
@@ -424,7 +424,7 @@ docker exec mcp-wordpress node -e \"
|
|
|
424
424
|
|
|
425
425
|
```bash
|
|
426
426
|
# Run with debug logging
|
|
427
|
-
docker run -e DEBUG=true
|
|
427
|
+
docker run -e DEBUG=true docdyhr/mcp-wordpress:latest
|
|
428
428
|
|
|
429
429
|
# Or with compose
|
|
430
430
|
environment:
|
|
@@ -442,9 +442,9 @@ environment:
|
|
|
442
442
|
|
|
443
443
|
## 🤝 Support
|
|
444
444
|
|
|
445
|
-
- **GitHub Issues**: [Report problems](https://github.com/
|
|
446
|
-
- **Discussions**: [Ask questions](https://github.com/
|
|
447
|
-
- **Documentation**: [Browse guides](https://github.com/
|
|
445
|
+
- **GitHub Issues**: [Report problems](https://github.com/docdyhr/mcp-wordpress/issues)
|
|
446
|
+
- **Discussions**: [Ask questions](https://github.com/docdyhr/mcp-wordpress/discussions)
|
|
447
|
+
- **Documentation**: [Browse guides](https://github.com/docdyhr/mcp-wordpress/tree/main/docs)
|
|
448
448
|
|
|
449
449
|
---
|
|
450
450
|
|
|
@@ -220,9 +220,9 @@ node_modules/
|
|
|
220
220
|
|
|
221
221
|
1. **Immediate Response:**
|
|
222
222
|
```bash
|
|
223
|
-
npm unpublish
|
|
223
|
+
npm unpublish mcp-wordpress@version
|
|
224
224
|
# Or deprecate if unpublish is not allowed
|
|
225
|
-
npm deprecate
|
|
225
|
+
npm deprecate mcp-wordpress@version "Security issue - use newer version"
|
|
226
226
|
```
|
|
227
227
|
|
|
228
228
|
2. **Credential Rotation:**
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mcp-wordpress",
|
|
3
|
-
"version": "1.2.
|
|
3
|
+
"version": "1.2.3",
|
|
4
4
|
"description": "Comprehensive Model Context Protocol server for WordPress management with 59 tools, performance monitoring, intelligent caching, auto-generated documentation, Docker support, TypeScript, and production-ready authentication",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"mcp",
|
|
@@ -11,13 +11,13 @@
|
|
|
11
11
|
"ai",
|
|
12
12
|
"assistant"
|
|
13
13
|
],
|
|
14
|
-
"homepage": "https://github.com/
|
|
14
|
+
"homepage": "https://github.com/docdyhr/mcp-wordpress#readme",
|
|
15
15
|
"bugs": {
|
|
16
|
-
"url": "https://github.com/
|
|
16
|
+
"url": "https://github.com/docdyhr/mcp-wordpress/issues"
|
|
17
17
|
},
|
|
18
18
|
"repository": {
|
|
19
19
|
"type": "git",
|
|
20
|
-
"url": "git+https://github.com/
|
|
20
|
+
"url": "git+https://github.com/docdyhr/mcp-wordpress.git"
|
|
21
21
|
},
|
|
22
22
|
"license": "MIT",
|
|
23
23
|
"author": "Thomas Dyhr",
|
|
@@ -56,6 +56,8 @@
|
|
|
56
56
|
"pre-commit": "lint-staged",
|
|
57
57
|
"prepare": "husky",
|
|
58
58
|
"prepublishOnly": "npm run build && npm run check:ignore",
|
|
59
|
+
"release": "semantic-release",
|
|
60
|
+
"release:dry": "semantic-release --dry-run",
|
|
59
61
|
"security:audit": "npm audit --production",
|
|
60
62
|
"security:check": "node scripts/security-check.js",
|
|
61
63
|
"security:fix": "npm audit fix",
|
|
@@ -110,6 +112,8 @@
|
|
|
110
112
|
"@jest/globals": "^30.0.0",
|
|
111
113
|
"@pact-foundation/pact": "^15.0.1",
|
|
112
114
|
"@pact-foundation/pact-node": "^10.18.0",
|
|
115
|
+
"@semantic-release/changelog": "^6.0.3",
|
|
116
|
+
"@semantic-release/git": "^10.0.1",
|
|
113
117
|
"@types/jest": "^30.0.0",
|
|
114
118
|
"@types/node": "^20.19.1",
|
|
115
119
|
"@typescript-eslint/parser": "^8.35.0",
|
|
@@ -124,6 +128,7 @@
|
|
|
124
128
|
"nock": "^14.0.5",
|
|
125
129
|
"open": "^9.1.0",
|
|
126
130
|
"prettier": "^3.6.2",
|
|
131
|
+
"semantic-release": "^24.8.0",
|
|
127
132
|
"sort-package-json": "^3.3.1",
|
|
128
133
|
"typescript": "^5.8.3"
|
|
129
134
|
},
|