mcp-wordpress 1.1.2 → 1.1.6

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.
Files changed (91) hide show
  1. package/README.md +8 -8
  2. package/bin/mcp-wordpress.js +1 -1
  3. package/dist/client/api.d.ts +10 -10
  4. package/dist/client/api.js +157 -157
  5. package/dist/client/api.js.map +1 -1
  6. package/dist/client/auth.d.ts +2 -2
  7. package/dist/client/auth.d.ts.map +1 -1
  8. package/dist/client/auth.js +72 -72
  9. package/dist/client/auth.js.map +1 -1
  10. package/dist/client/managers/AuthenticationManager.d.ts +2 -2
  11. package/dist/client/managers/AuthenticationManager.d.ts.map +1 -1
  12. package/dist/client/managers/AuthenticationManager.js +50 -46
  13. package/dist/client/managers/AuthenticationManager.js.map +1 -1
  14. package/dist/client/managers/BaseManager.d.ts +1 -1
  15. package/dist/client/managers/BaseManager.d.ts.map +1 -1
  16. package/dist/client/managers/BaseManager.js +9 -9
  17. package/dist/client/managers/BaseManager.js.map +1 -1
  18. package/dist/client/managers/RequestManager.d.ts +2 -2
  19. package/dist/client/managers/RequestManager.js +15 -15
  20. package/dist/client/managers/index.d.ts +3 -3
  21. package/dist/client/managers/index.js +3 -3
  22. package/dist/index.d.ts.map +1 -1
  23. package/dist/index.js +78 -61
  24. package/dist/index.js.map +1 -1
  25. package/dist/tools/auth.d.ts +2 -2
  26. package/dist/tools/auth.js +31 -31
  27. package/dist/tools/auth.js.map +1 -1
  28. package/dist/tools/comments.d.ts +2 -2
  29. package/dist/tools/comments.js +79 -79
  30. package/dist/tools/media.d.ts +2 -2
  31. package/dist/tools/media.d.ts.map +1 -1
  32. package/dist/tools/media.js +80 -80
  33. package/dist/tools/media.js.map +1 -1
  34. package/dist/tools/pages.d.ts +2 -2
  35. package/dist/tools/pages.js +75 -75
  36. package/dist/tools/posts.d.ts +2 -2
  37. package/dist/tools/posts.js +94 -94
  38. package/dist/tools/site.d.ts +2 -2
  39. package/dist/tools/site.js +60 -60
  40. package/dist/tools/site.js.map +1 -1
  41. package/dist/tools/taxonomies.d.ts +2 -2
  42. package/dist/tools/taxonomies.js +89 -89
  43. package/dist/tools/users.d.ts +2 -2
  44. package/dist/tools/users.js +68 -68
  45. package/dist/tools/users.js.map +1 -1
  46. package/dist/types/mcp.d.ts +1 -1
  47. package/dist/types/mcp.d.ts.map +1 -1
  48. package/dist/utils/debug.d.ts.map +1 -1
  49. package/dist/utils/debug.js +10 -6
  50. package/dist/utils/debug.js.map +1 -1
  51. package/dist/utils/toolWrapper.js +3 -3
  52. package/docs/developer/GITHUB_ACTIONS_SETUP.md +208 -0
  53. package/docs/developer/MAINTENANCE.md +307 -0
  54. package/docs/developer/MIGRATION_GUIDE.md +172 -0
  55. package/docs/developer/NPM_AUTH_SETUP.md +142 -0
  56. package/docs/developer/REFACTORING.md +196 -0
  57. package/docs/releases/COMMUNITY_ANNOUNCEMENT_v1.1.2.md +126 -0
  58. package/docs/releases/RELEASE_NOTES_v1.1.2.md +173 -0
  59. package/docs/user-guides/CLAUDE_DESKTOP_SETUP.md +187 -0
  60. package/package.json +4 -3
  61. package/src/client/api.ts +229 -229
  62. package/src/client/auth.ts +135 -136
  63. package/src/client/managers/AuthenticationManager.ts +148 -105
  64. package/src/client/managers/BaseManager.ts +15 -12
  65. package/src/client/managers/RequestManager.ts +17 -17
  66. package/src/client/managers/index.ts +3 -3
  67. package/src/index.ts +141 -114
  68. package/src/server.ts +1 -1
  69. package/src/tools/auth.ts +36 -36
  70. package/src/tools/comments.ts +90 -90
  71. package/src/tools/media.ts +89 -91
  72. package/src/tools/pages.ts +86 -86
  73. package/src/tools/posts.ts +106 -106
  74. package/src/tools/site.ts +71 -71
  75. package/src/tools/taxonomies.ts +102 -102
  76. package/src/tools/users.ts +77 -77
  77. package/src/types/client.ts +1 -1
  78. package/src/types/index.ts +1 -1
  79. package/src/types/mcp.ts +36 -16
  80. package/src/types/wordpress.ts +1 -1
  81. package/src/utils/debug.ts +63 -39
  82. package/src/utils/error.ts +1 -1
  83. package/src/utils/toolWrapper.ts +4 -4
  84. package/dist/client/WordPressClient.d.ts +0 -81
  85. package/dist/client/WordPressClient.d.ts.map +0 -1
  86. package/dist/client/WordPressClient.js +0 -354
  87. package/dist/client/WordPressClient.js.map +0 -1
  88. package/dist/tools/base.d.ts +0 -37
  89. package/dist/tools/base.d.ts.map +0 -1
  90. package/dist/tools/base.js +0 -60
  91. package/dist/tools/base.js.map +0 -1
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  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.
4
4
 
5
- [![NPM Version](https://img.shields.io/npm/v/@aiondadotcom/mcp-wordpress)](https://www.npmjs.com/package/@aiondadotcom/mcp-wordpress)
5
+ [![NPM Version](https://img.shields.io/npm/v/mcp-wordpress)](https://www.npmjs.com/package/mcp-wordpress)
6
6
  [![Test Coverage](https://img.shields.io/badge/test%20coverage-95%25%2B-brightgreen)](https://github.com/AiondaDotCom/mcp-wordpress)
7
7
  [![TypeScript](https://img.shields.io/badge/TypeScript-100%25-blue)](https://github.com/AiondaDotCom/mcp-wordpress)
8
8
  [![Architecture](https://img.shields.io/badge/architecture-modular-orange)](https://github.com/AiondaDotCom/mcp-wordpress/blob/main/REFACTORING.md)
@@ -28,10 +28,10 @@ The easiest way to get started - no installation required:
28
28
 
29
29
  ```bash
30
30
  # Run directly with NPX
31
- npx @aiondadotcom/mcp-wordpress
31
+ npx mcp-wordpress
32
32
 
33
33
  # Or install globally
34
- npm install -g @aiondadotcom/mcp-wordpress
34
+ npm install -g mcp-wordpress
35
35
  mcp-wordpress
36
36
  ```
37
37
 
@@ -49,7 +49,7 @@ npm start
49
49
 
50
50
  ```bash
51
51
  # For NPX users
52
- npx @aiondadotcom/mcp-wordpress setup
52
+ npx mcp-wordpress setup
53
53
 
54
54
  # For local installation
55
55
  npm run setup
@@ -108,7 +108,7 @@ Please:
108
108
  3. Test the connection to make sure everything works
109
109
  4. Show me how to use the WordPress tools
110
110
 
111
- I want to use the NPX version (@aiondadotcom/mcp-wordpress) so I don't need to install anything locally.
111
+ I want to use the NPX version (mcp-wordpress) so I don't need to install anything locally.
112
112
  ```
113
113
 
114
114
  ### Full Local Development Setup
@@ -156,7 +156,7 @@ Configure MCP WordPress Server in your Claude Desktop `mcp.json` configuration f
156
156
  "mcpServers": {
157
157
  "mcp-wordpress": {
158
158
  "command": "npx",
159
- "args": ["@aiondadotcom/mcp-wordpress"],
159
+ "args": ["mcp-wordpress"],
160
160
  "env": {
161
161
  "WORDPRESS_SITE_URL": "https://your-site.com",
162
162
  "WORDPRESS_USERNAME": "your-username",
@@ -211,7 +211,7 @@ If you prefer to use a `.env` file instead of environment variables in the confi
211
211
  "mcpServers": {
212
212
  "mcp-wordpress": {
213
213
  "command": "npx",
214
- "args": ["@aiondadotcom/mcp-wordpress"],
214
+ "args": ["mcp-wordpress"],
215
215
  "env": {
216
216
  "NODE_ENV": "production"
217
217
  }
@@ -242,7 +242,7 @@ Here's a complete `claude_desktop_config.json` file with MCP WordPress:
242
242
  "mcpServers": {
243
243
  "mcp-wordpress": {
244
244
  "command": "npx",
245
- "args": ["@aiondadotcom/mcp-wordpress"],
245
+ "args": ["mcp-wordpress"],
246
246
  "env": {
247
247
  "WORDPRESS_SITE_URL": "https://your-site.com",
248
248
  "WORDPRESS_USERNAME": "your-username",
@@ -9,4 +9,4 @@ const __dirname = path.dirname(__filename);
9
9
 
10
10
  // Import and run the main module from dist
11
11
  const mainModule = path.join(__dirname, '..', 'dist', 'index.js');
12
- import(mainModule);
12
+ import(mainModule);
@@ -2,8 +2,8 @@
2
2
  * WordPress API Client
3
3
  * Handles all REST API communication with WordPress
4
4
  */
5
- import type { IWordPressClient, WordPressClientConfig, HTTPMethod, RequestOptions, ClientStats } from "../types/client.js";
6
- import type { WordPressPost, WordPressPage, WordPressMedia, WordPressUser, WordPressComment, WordPressCategory, WordPressTag, WordPressSiteSettings, WordPressApplicationPassword, PostQueryParams, MediaQueryParams, UserQueryParams, CommentQueryParams, CreatePostRequest, UpdatePostRequest, CreatePageRequest, UpdatePageRequest, CreateUserRequest, UpdateUserRequest, CreateCommentRequest, UpdateCommentRequest, CreateCategoryRequest, UpdateCategoryRequest, CreateTagRequest, UpdateTagRequest, UploadMediaRequest, UpdateMediaRequest } from "../types/wordpress.js";
5
+ import type { IWordPressClient, WordPressClientConfig, HTTPMethod, RequestOptions, ClientStats } from '../types/client.js';
6
+ import type { WordPressPost, WordPressPage, WordPressMedia, WordPressUser, WordPressComment, WordPressCategory, WordPressTag, WordPressSiteSettings, WordPressApplicationPassword, PostQueryParams, MediaQueryParams, UserQueryParams, CommentQueryParams, CreatePostRequest, UpdatePostRequest, CreatePageRequest, UpdatePageRequest, CreateUserRequest, UpdateUserRequest, CreateCommentRequest, UpdateCommentRequest, CreateCategoryRequest, UpdateCategoryRequest, CreateTagRequest, UpdateTagRequest, UploadMediaRequest, UpdateMediaRequest } from '../types/wordpress.js';
7
7
  export declare class WordPressClient implements IWordPressClient {
8
8
  private baseUrl;
9
9
  private apiUrl;
@@ -60,7 +60,7 @@ export declare class WordPressClient implements IWordPressClient {
60
60
  patch<T = any>(endpoint: string, data?: any, options?: RequestOptions): Promise<T>;
61
61
  delete<T = any>(endpoint: string, options?: RequestOptions): Promise<T>;
62
62
  getPosts(params?: PostQueryParams): Promise<WordPressPost[]>;
63
- getPost(id: number, context?: "view" | "embed" | "edit"): Promise<WordPressPost>;
63
+ getPost(id: number, context?: 'view' | 'embed' | 'edit'): Promise<WordPressPost>;
64
64
  createPost(data: CreatePostRequest): Promise<WordPressPost>;
65
65
  updatePost(data: UpdatePostRequest): Promise<WordPressPost>;
66
66
  deletePost(id: number, force?: boolean): Promise<{
@@ -69,7 +69,7 @@ export declare class WordPressClient implements IWordPressClient {
69
69
  }>;
70
70
  getPostRevisions(id: number): Promise<WordPressPost[]>;
71
71
  getPages(params?: PostQueryParams): Promise<WordPressPage[]>;
72
- getPage(id: number, context?: "view" | "embed" | "edit"): Promise<WordPressPage>;
72
+ getPage(id: number, context?: 'view' | 'embed' | 'edit'): Promise<WordPressPage>;
73
73
  createPage(data: CreatePageRequest): Promise<WordPressPage>;
74
74
  updatePage(data: UpdatePageRequest): Promise<WordPressPage>;
75
75
  deletePage(id: number, force?: boolean): Promise<{
@@ -78,7 +78,7 @@ export declare class WordPressClient implements IWordPressClient {
78
78
  }>;
79
79
  getPageRevisions(id: number): Promise<WordPressPage[]>;
80
80
  getMedia(params?: MediaQueryParams): Promise<WordPressMedia[]>;
81
- getMediaItem(id: number, context?: "view" | "embed" | "edit"): Promise<WordPressMedia>;
81
+ getMediaItem(id: number, context?: 'view' | 'embed' | 'edit'): Promise<WordPressMedia>;
82
82
  uploadMedia(data: UploadMediaRequest): Promise<WordPressMedia>;
83
83
  uploadFile(fileData: Buffer, filename: string, mimeType: string, meta?: Partial<UploadMediaRequest>, options?: RequestOptions): Promise<WordPressMedia>;
84
84
  updateMedia(data: UpdateMediaRequest): Promise<WordPressMedia>;
@@ -87,7 +87,7 @@ export declare class WordPressClient implements IWordPressClient {
87
87
  previous?: WordPressMedia;
88
88
  }>;
89
89
  getUsers(params?: UserQueryParams): Promise<WordPressUser[]>;
90
- getUser(id: number | "me", context?: "view" | "embed" | "edit"): Promise<WordPressUser>;
90
+ getUser(id: number | 'me', context?: 'view' | 'embed' | 'edit'): Promise<WordPressUser>;
91
91
  createUser(data: CreateUserRequest): Promise<WordPressUser>;
92
92
  updateUser(data: UpdateUserRequest): Promise<WordPressUser>;
93
93
  deleteUser(id: number, reassign?: number): Promise<{
@@ -96,7 +96,7 @@ export declare class WordPressClient implements IWordPressClient {
96
96
  }>;
97
97
  getCurrentUser(): Promise<WordPressUser>;
98
98
  getComments(params?: CommentQueryParams): Promise<WordPressComment[]>;
99
- getComment(id: number, context?: "view" | "embed" | "edit"): Promise<WordPressComment>;
99
+ getComment(id: number, context?: 'view' | 'embed' | 'edit'): Promise<WordPressComment>;
100
100
  createComment(data: CreateCommentRequest): Promise<WordPressComment>;
101
101
  updateComment(data: UpdateCommentRequest): Promise<WordPressComment>;
102
102
  deleteComment(id: number, force?: boolean): Promise<{
@@ -125,9 +125,9 @@ export declare class WordPressClient implements IWordPressClient {
125
125
  getSiteSettings(): Promise<WordPressSiteSettings>;
126
126
  updateSiteSettings(settings: Partial<WordPressSiteSettings>): Promise<WordPressSiteSettings>;
127
127
  getSiteInfo(): Promise<any>;
128
- getApplicationPasswords(userId?: number | "me"): Promise<WordPressApplicationPassword[]>;
129
- createApplicationPassword(userId: number | "me", name: string, appId?: string): Promise<WordPressApplicationPassword>;
130
- deleteApplicationPassword(userId: number | "me", uuid: string): Promise<{
128
+ getApplicationPasswords(userId?: number | 'me'): Promise<WordPressApplicationPassword[]>;
129
+ createApplicationPassword(userId: number | 'me', name: string, appId?: string): Promise<WordPressApplicationPassword>;
130
+ deleteApplicationPassword(userId: number | 'me', uuid: string): Promise<{
131
131
  deleted: boolean;
132
132
  }>;
133
133
  search(query: string, types?: string[], subtype?: string): Promise<any[]>;