@wpgaurav/wp-mcp 0.1.0

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 (118) hide show
  1. package/README.md +215 -0
  2. package/dist/bin/wp-mcp.d.ts +3 -0
  3. package/dist/bin/wp-mcp.d.ts.map +1 -0
  4. package/dist/bin/wp-mcp.js +44 -0
  5. package/dist/bin/wp-mcp.js.map +1 -0
  6. package/dist/src/client/auth.d.ts +2 -0
  7. package/dist/src/client/auth.d.ts.map +1 -0
  8. package/dist/src/client/auth.js +5 -0
  9. package/dist/src/client/auth.js.map +1 -0
  10. package/dist/src/client/errors.d.ts +14 -0
  11. package/dist/src/client/errors.d.ts.map +1 -0
  12. package/dist/src/client/errors.js +27 -0
  13. package/dist/src/client/errors.js.map +1 -0
  14. package/dist/src/client/wp-client.d.ts +24 -0
  15. package/dist/src/client/wp-client.d.ts.map +1 -0
  16. package/dist/src/client/wp-client.js +101 -0
  17. package/dist/src/client/wp-client.js.map +1 -0
  18. package/dist/src/config.d.ts +11 -0
  19. package/dist/src/config.d.ts.map +1 -0
  20. package/dist/src/config.js +20 -0
  21. package/dist/src/config.js.map +1 -0
  22. package/dist/src/discovery/engine.d.ts +5 -0
  23. package/dist/src/discovery/engine.d.ts.map +1 -0
  24. package/dist/src/discovery/engine.js +116 -0
  25. package/dist/src/discovery/engine.js.map +1 -0
  26. package/dist/src/discovery/naming.d.ts +4 -0
  27. package/dist/src/discovery/naming.d.ts.map +1 -0
  28. package/dist/src/discovery/naming.js +42 -0
  29. package/dist/src/discovery/naming.js.map +1 -0
  30. package/dist/src/discovery/schema-mapper.d.ts +18 -0
  31. package/dist/src/discovery/schema-mapper.d.ts.map +1 -0
  32. package/dist/src/discovery/schema-mapper.js +103 -0
  33. package/dist/src/discovery/schema-mapper.js.map +1 -0
  34. package/dist/src/discovery/tool-generator.d.ts +13 -0
  35. package/dist/src/discovery/tool-generator.d.ts.map +1 -0
  36. package/dist/src/discovery/tool-generator.js +58 -0
  37. package/dist/src/discovery/tool-generator.js.map +1 -0
  38. package/dist/src/index.d.ts +6 -0
  39. package/dist/src/index.d.ts.map +1 -0
  40. package/dist/src/index.js +5 -0
  41. package/dist/src/index.js.map +1 -0
  42. package/dist/src/server.d.ts +11 -0
  43. package/dist/src/server.d.ts.map +1 -0
  44. package/dist/src/server.js +21 -0
  45. package/dist/src/server.js.map +1 -0
  46. package/dist/src/tools/advanced/menus.d.ts +5 -0
  47. package/dist/src/tools/advanced/menus.d.ts.map +1 -0
  48. package/dist/src/tools/advanced/menus.js +33 -0
  49. package/dist/src/tools/advanced/menus.js.map +1 -0
  50. package/dist/src/tools/advanced/search.d.ts +5 -0
  51. package/dist/src/tools/advanced/search.d.ts.map +1 -0
  52. package/dist/src/tools/advanced/search.js +24 -0
  53. package/dist/src/tools/advanced/search.js.map +1 -0
  54. package/dist/src/tools/advanced/site-health.d.ts +5 -0
  55. package/dist/src/tools/advanced/site-health.d.ts.map +1 -0
  56. package/dist/src/tools/advanced/site-health.js +16 -0
  57. package/dist/src/tools/advanced/site-health.js.map +1 -0
  58. package/dist/src/tools/content/categories.d.ts +5 -0
  59. package/dist/src/tools/content/categories.d.ts.map +1 -0
  60. package/dist/src/tools/content/categories.js +43 -0
  61. package/dist/src/tools/content/categories.js.map +1 -0
  62. package/dist/src/tools/content/comments.d.ts +5 -0
  63. package/dist/src/tools/content/comments.d.ts.map +1 -0
  64. package/dist/src/tools/content/comments.js +45 -0
  65. package/dist/src/tools/content/comments.js.map +1 -0
  66. package/dist/src/tools/content/media.d.ts +5 -0
  67. package/dist/src/tools/content/media.d.ts.map +1 -0
  68. package/dist/src/tools/content/media.js +97 -0
  69. package/dist/src/tools/content/media.js.map +1 -0
  70. package/dist/src/tools/content/pages.d.ts +5 -0
  71. package/dist/src/tools/content/pages.d.ts.map +1 -0
  72. package/dist/src/tools/content/pages.js +98 -0
  73. package/dist/src/tools/content/pages.js.map +1 -0
  74. package/dist/src/tools/content/posts.d.ts +5 -0
  75. package/dist/src/tools/content/posts.d.ts.map +1 -0
  76. package/dist/src/tools/content/posts.js +107 -0
  77. package/dist/src/tools/content/posts.js.map +1 -0
  78. package/dist/src/tools/content/tags.d.ts +5 -0
  79. package/dist/src/tools/content/tags.d.ts.map +1 -0
  80. package/dist/src/tools/content/tags.js +41 -0
  81. package/dist/src/tools/content/tags.js.map +1 -0
  82. package/dist/src/tools/index.d.ts +5 -0
  83. package/dist/src/tools/index.d.ts.map +1 -0
  84. package/dist/src/tools/index.js +29 -0
  85. package/dist/src/tools/index.js.map +1 -0
  86. package/dist/src/tools/management/plugins.d.ts +5 -0
  87. package/dist/src/tools/management/plugins.d.ts.map +1 -0
  88. package/dist/src/tools/management/plugins.js +67 -0
  89. package/dist/src/tools/management/plugins.js.map +1 -0
  90. package/dist/src/tools/management/settings.d.ts +5 -0
  91. package/dist/src/tools/management/settings.d.ts.map +1 -0
  92. package/dist/src/tools/management/settings.js +37 -0
  93. package/dist/src/tools/management/settings.js.map +1 -0
  94. package/dist/src/tools/management/themes.d.ts +5 -0
  95. package/dist/src/tools/management/themes.d.ts.map +1 -0
  96. package/dist/src/tools/management/themes.js +34 -0
  97. package/dist/src/tools/management/themes.js.map +1 -0
  98. package/dist/src/tools/management/users.d.ts +5 -0
  99. package/dist/src/tools/management/users.d.ts.map +1 -0
  100. package/dist/src/tools/management/users.js +69 -0
  101. package/dist/src/tools/management/users.js.map +1 -0
  102. package/dist/src/tools/registry.d.ts +7 -0
  103. package/dist/src/tools/registry.d.ts.map +1 -0
  104. package/dist/src/tools/registry.js +13 -0
  105. package/dist/src/tools/registry.js.map +1 -0
  106. package/dist/src/tools/shared.d.ts +20 -0
  107. package/dist/src/tools/shared.d.ts.map +1 -0
  108. package/dist/src/tools/shared.js +15 -0
  109. package/dist/src/tools/shared.js.map +1 -0
  110. package/dist/src/transports/http.d.ts +3 -0
  111. package/dist/src/transports/http.d.ts.map +1 -0
  112. package/dist/src/transports/http.js +53 -0
  113. package/dist/src/transports/http.js.map +1 -0
  114. package/dist/src/transports/stdio.d.ts +3 -0
  115. package/dist/src/transports/stdio.d.ts.map +1 -0
  116. package/dist/src/transports/stdio.js +5 -0
  117. package/dist/src/transports/stdio.js.map +1 -0
  118. package/package.json +59 -0
@@ -0,0 +1,34 @@
1
+ import { z } from "zod";
2
+ import { handleWpError, jsonResult } from "../shared.js";
3
+ export function registerThemesTools(server, client, registry) {
4
+ server.registerTool("wp_themes_list", {
5
+ description: "List installed WordPress themes",
6
+ inputSchema: {},
7
+ }, async () => {
8
+ try {
9
+ return jsonResult(await client.request("/wp/v2/themes"));
10
+ }
11
+ catch (err) {
12
+ return handleWpError(err);
13
+ }
14
+ });
15
+ registry.register("wp_themes_list");
16
+ server.registerTool("wp_themes_activate", {
17
+ description: "Activate a WordPress theme by its stylesheet name",
18
+ inputSchema: {
19
+ stylesheet: z.string().describe("Theme stylesheet identifier (e.g. 'twentytwentyfour')"),
20
+ },
21
+ }, async ({ stylesheet }) => {
22
+ try {
23
+ return jsonResult(await client.request(`/wp/v2/themes/${stylesheet}`, {
24
+ method: "PUT",
25
+ body: { status: "active" },
26
+ }));
27
+ }
28
+ catch (err) {
29
+ return handleWpError(err);
30
+ }
31
+ });
32
+ registry.register("wp_themes_activate");
33
+ }
34
+ //# sourceMappingURL=themes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"themes.js","sourceRoot":"","sources":["../../../../src/tools/management/themes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAgB,EAAE,QAAsB;IAC7F,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EAAE,iCAAiC;QAC9C,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,OAAO,UAAU,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IACF,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAEpC,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,WAAW,EAAE,mDAAmD;QAChE,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;SACzF;KACF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,OAAO,UAAU,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,iBAAiB,UAAU,EAAE,EAAE;gBACpE,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;aAC3B,CAAC,CAAC,CAAC;QACN,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IACF,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;AAC1C,CAAC"}
@@ -0,0 +1,5 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import type { WpClient } from "../../client/wp-client.js";
3
+ import type { ToolRegistry } from "../registry.js";
4
+ export declare function registerUsersTools(server: McpServer, client: WpClient, registry: ToolRegistry): void;
5
+ //# sourceMappingURL=users.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../../../src/tools/management/users.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAgFpG"}
@@ -0,0 +1,69 @@
1
+ import { z } from "zod";
2
+ import { handleWpError, paginatedResult, jsonResult } from "../shared.js";
3
+ export function registerUsersTools(server, client, registry) {
4
+ server.registerTool("wp_users_list", {
5
+ description: "List WordPress users",
6
+ inputSchema: {
7
+ per_page: z.number().int().min(1).max(100).default(10).describe("Users per page"),
8
+ page: z.number().int().min(1).default(1).describe("Page number"),
9
+ search: z.string().optional().describe("Search term"),
10
+ roles: z.string().optional().describe("Comma-separated roles to filter by"),
11
+ orderby: z.enum(["id", "name", "slug", "registered_date", "email"]).optional().describe("Sort field"),
12
+ order: z.enum(["asc", "desc"]).optional().describe("Sort order"),
13
+ },
14
+ }, async (args) => {
15
+ try {
16
+ const result = await client.requestPaginated("/wp/v2/users", { params: args });
17
+ return paginatedResult(result.data, result.total, result.totalPages);
18
+ }
19
+ catch (err) {
20
+ return handleWpError(err);
21
+ }
22
+ });
23
+ registry.register("wp_users_list");
24
+ server.registerTool("wp_users_get", {
25
+ description: "Get a WordPress user by ID",
26
+ inputSchema: { id: z.number().int().describe("User ID") },
27
+ }, async ({ id }) => {
28
+ try {
29
+ return jsonResult(await client.request(`/wp/v2/users/${id}`));
30
+ }
31
+ catch (err) {
32
+ return handleWpError(err);
33
+ }
34
+ });
35
+ registry.register("wp_users_get");
36
+ server.registerTool("wp_users_create", {
37
+ description: "Create a new WordPress user",
38
+ inputSchema: {
39
+ username: z.string().describe("Username (login name)"),
40
+ email: z.string().email().describe("User email"),
41
+ password: z.string().describe("User password"),
42
+ name: z.string().optional().describe("Display name"),
43
+ first_name: z.string().optional().describe("First name"),
44
+ last_name: z.string().optional().describe("Last name"),
45
+ roles: z.array(z.string()).optional().describe("User roles"),
46
+ },
47
+ }, async (args) => {
48
+ try {
49
+ return jsonResult(await client.request("/wp/v2/users", { method: "POST", body: args }));
50
+ }
51
+ catch (err) {
52
+ return handleWpError(err);
53
+ }
54
+ });
55
+ registry.register("wp_users_create");
56
+ server.registerTool("wp_users_me", {
57
+ description: "Get the currently authenticated WordPress user",
58
+ inputSchema: {},
59
+ }, async () => {
60
+ try {
61
+ return jsonResult(await client.request("/wp/v2/users/me"));
62
+ }
63
+ catch (err) {
64
+ return handleWpError(err);
65
+ }
66
+ });
67
+ registry.register("wp_users_me");
68
+ }
69
+ //# sourceMappingURL=users.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"users.js","sourceRoot":"","sources":["../../../../src/tools/management/users.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ export declare class ToolRegistry {
2
+ private readonly registered;
3
+ has(name: string): boolean;
4
+ register(name: string): void;
5
+ all(): string[];
6
+ }
7
+ //# sourceMappingURL=registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAEhD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,GAAG,IAAI,MAAM,EAAE;CAGhB"}
@@ -0,0 +1,13 @@
1
+ export class ToolRegistry {
2
+ registered = new Set();
3
+ has(name) {
4
+ return this.registered.has(name);
5
+ }
6
+ register(name) {
7
+ this.registered.add(name);
8
+ }
9
+ all() {
10
+ return [...this.registered];
11
+ }
12
+ }
13
+ //# sourceMappingURL=registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAY;IACN,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhD,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,QAAQ,CAAC,IAAY;QACnB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,GAAG;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;CACF"}
@@ -0,0 +1,20 @@
1
+ export declare function handleWpError(err: unknown): {
2
+ content: Array<{
3
+ type: "text";
4
+ text: string;
5
+ }>;
6
+ isError: true;
7
+ };
8
+ export declare function jsonResult(data: unknown): {
9
+ content: Array<{
10
+ type: "text";
11
+ text: string;
12
+ }>;
13
+ };
14
+ export declare function paginatedResult(data: unknown, total: number, totalPages: number): {
15
+ content: Array<{
16
+ type: "text";
17
+ text: string;
18
+ }>;
19
+ };
20
+ //# sourceMappingURL=shared.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/tools/shared.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAM7G;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAE5F;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAEpI"}
@@ -0,0 +1,15 @@
1
+ import { WpApiError } from "../client/errors.js";
2
+ export function handleWpError(err) {
3
+ if (err instanceof WpApiError) {
4
+ return err.toMcpError();
5
+ }
6
+ const message = err instanceof Error ? err.message : String(err);
7
+ return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
8
+ }
9
+ export function jsonResult(data) {
10
+ return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
11
+ }
12
+ export function paginatedResult(data, total, totalPages) {
13
+ return { content: [{ type: "text", text: JSON.stringify({ data, total, totalPages }, null, 2) }] };
14
+ }
15
+ //# sourceMappingURL=shared.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/tools/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;QAC9B,OAAO,GAAG,CAAC,UAAU,EAAE,CAAC;IAC1B,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAa,EAAE,KAAa,EAAE,UAAkB;IAC9E,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACrG,CAAC"}
@@ -0,0 +1,3 @@
1
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ export declare function startHttpTransport(server: McpServer, host: string, port: number): Promise<void>;
3
+ //# sourceMappingURL=http.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/transports/http.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAyDf"}
@@ -0,0 +1,53 @@
1
+ import express from "express";
2
+ import { randomUUID } from "node:crypto";
3
+ import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
4
+ export async function startHttpTransport(server, host, port) {
5
+ const app = express();
6
+ const transports = new Map();
7
+ app.post("/mcp", async (req, res) => {
8
+ const sessionId = req.headers["mcp-session-id"];
9
+ if (sessionId && transports.has(sessionId)) {
10
+ const transport = transports.get(sessionId);
11
+ await transport.handleRequest(req, res);
12
+ return;
13
+ }
14
+ const transport = new StreamableHTTPServerTransport({
15
+ sessionIdGenerator: () => randomUUID(),
16
+ onsessioninitialized: (id) => {
17
+ transports.set(id, transport);
18
+ },
19
+ });
20
+ transport.onclose = () => {
21
+ if (transport.sessionId) {
22
+ transports.delete(transport.sessionId);
23
+ }
24
+ };
25
+ await server.connect(transport);
26
+ await transport.handleRequest(req, res);
27
+ });
28
+ app.get("/mcp", async (req, res) => {
29
+ const sessionId = req.headers["mcp-session-id"];
30
+ if (!sessionId || !transports.has(sessionId)) {
31
+ res.status(400).json({ error: "Invalid or missing session ID" });
32
+ return;
33
+ }
34
+ const transport = transports.get(sessionId);
35
+ await transport.handleRequest(req, res);
36
+ });
37
+ app.delete("/mcp", async (req, res) => {
38
+ const sessionId = req.headers["mcp-session-id"];
39
+ if (!sessionId || !transports.has(sessionId)) {
40
+ res.status(400).json({ error: "Invalid or missing session ID" });
41
+ return;
42
+ }
43
+ const transport = transports.get(sessionId);
44
+ await transport.handleRequest(req, res);
45
+ });
46
+ await new Promise((resolve) => {
47
+ app.listen(port, host, () => {
48
+ console.error(`wp-mcp HTTP server listening on http://${host}:${port}/mcp`);
49
+ resolve();
50
+ });
51
+ });
52
+ }
53
+ //# sourceMappingURL=http.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/transports/http.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
2
+ export declare function createStdioTransport(): StdioServerTransport;
3
+ //# sourceMappingURL=stdio.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../../src/transports/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,wBAAgB,oBAAoB,IAAI,oBAAoB,CAE3D"}
@@ -0,0 +1,5 @@
1
+ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
2
+ export function createStdioTransport() {
3
+ return new StdioServerTransport();
4
+ }
5
+ //# sourceMappingURL=stdio.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../../src/transports/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,oBAAoB,EAAE,CAAC;AACpC,CAAC"}
package/package.json ADDED
@@ -0,0 +1,59 @@
1
+ {
2
+ "name": "@wpgaurav/wp-mcp",
3
+ "version": "0.1.0",
4
+ "description": "WordPress MCP Server — expose any WordPress site's REST API as MCP tools with auto-discovery of custom plugin endpoints",
5
+ "type": "module",
6
+ "bin": {
7
+ "wp-mcp": "./dist/bin/wp-mcp.js"
8
+ },
9
+ "main": "./dist/src/index.js",
10
+ "types": "./dist/src/index.d.ts",
11
+ "exports": {
12
+ ".": {
13
+ "import": "./dist/src/index.js",
14
+ "types": "./dist/src/index.d.ts"
15
+ }
16
+ },
17
+ "files": [
18
+ "dist",
19
+ "README.md"
20
+ ],
21
+ "scripts": {
22
+ "build": "tsc -p tsconfig.build.json",
23
+ "dev": "tsx bin/wp-mcp.ts",
24
+ "test": "vitest run",
25
+ "test:watch": "vitest",
26
+ "typecheck": "tsc --noEmit",
27
+ "prepare": "npm run build",
28
+ "prepublishOnly": "npm run build"
29
+ },
30
+ "keywords": [
31
+ "wordpress",
32
+ "mcp",
33
+ "model-context-protocol",
34
+ "wp-api",
35
+ "woocommerce",
36
+ "acf"
37
+ ],
38
+ "author": "Gaurav Tiwari",
39
+ "license": "MIT",
40
+ "repository": {
41
+ "type": "git",
42
+ "url": "https://github.com/wpgaurav/wp-mcp.git"
43
+ },
44
+ "engines": {
45
+ "node": ">=18.0.0"
46
+ },
47
+ "dependencies": {
48
+ "@modelcontextprotocol/sdk": "^1.12.0",
49
+ "express": "^5.1.0",
50
+ "zod": "^3.25.0"
51
+ },
52
+ "devDependencies": {
53
+ "@types/express": "^5.0.0",
54
+ "@types/node": "^22.0.0",
55
+ "tsx": "^4.16.0",
56
+ "typescript": "^5.5.0",
57
+ "vitest": "^4.0.0"
58
+ }
59
+ }