@adsim/wordpress-mcp-server 3.0.0 → 3.1.0

package/dxt/build-mcpb.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -e
+cd "$(dirname "$0")/.."
+npm install --omit=dev --ignore-scripts
+cd dxt
+npx @anthropic-ai/mcpb pack . --output ../wordpress-mcp-server.mcpb
+echo "Bundle created: wordpress-mcp-server.mcpb"

package/dxt/manifest.json

@@ -0,0 +1,112 @@
+{
+  "manifest_version": "0.3",
+  "name": "wordpress-mcp-server",
+  "display_name": "WordPress MCP Server",
+  "version": "3.0.0",
+  "description": "Manage your WordPress site from Claude Desktop — posts, pages, media, SEO, plugins, themes, revisions, and more. No WordPress plugin required.",
+  "long_description": "A full-featured MCP server for WordPress REST API integration. Manage posts, pages, media, categories, tags, comments, users, SEO metadata, plugins, themes, and revisions through 35 tools — all from Claude Desktop.\n\nNo WordPress plugin required. Uses the built-in WordPress REST API with Application Passwords for secure authentication.\n\nFeatures:\n- Content management: create, read, update, delete posts and pages\n- Media library: list, get details, upload from URL\n- Taxonomy: categories, tags, custom post types\n- SEO: auto-detects Yoast, RankMath, SEOPress, or All in One SEO\n- Plugins & themes: list, activate, deactivate\n- Revisions: list, view, restore, delete\n- Enterprise controls: read-only mode, draft-only, disable-delete\n- Multi-site: target multiple WordPress installations",
+  "author": {
+    "name": "AdSim",
+    "email": "georges@adsim.be",
+    "url": "https://adsim.be"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/adsimbe/wordpress-mcp-server.git"
+  },
+  "homepage": "https://github.com/adsimbe/wordpress-mcp-server#readme",
+  "support": "https://github.com/adsimbe/wordpress-mcp-server/issues",
+  "server": {
+    "type": "node",
+    "entry_point": "server/index.js",
+    "mcp_config": {
+      "command": "node",
+      "args": [
+        "${__dirname}/server/index.js"
+      ],
+      "env": {
+        "WP_API_URL": "${user_config.wp_api_url}",
+        "WP_API_USERNAME": "${user_config.wp_api_username}",
+        "WP_API_PASSWORD": "${user_config.wp_api_password}"
+      }
+    }
+  },
+  "tools": [
+    { "name": "wp_list_posts", "description": "List posts with filtering and search" },
+    { "name": "wp_get_post", "description": "Get post by ID with full content and meta" },
+    { "name": "wp_create_post", "description": "Create a post (default: draft)" },
+    { "name": "wp_update_post", "description": "Update a post" },
+    { "name": "wp_delete_post", "description": "Delete a post (trash or permanent)" },
+    { "name": "wp_search", "description": "Full-text search across all content" },
+    { "name": "wp_list_pages", "description": "List pages with hierarchy" },
+    { "name": "wp_get_page", "description": "Get page by ID with content and template" },
+    { "name": "wp_create_page", "description": "Create a page (default: draft)" },
+    { "name": "wp_update_page", "description": "Update a page" },
+    { "name": "wp_list_media", "description": "List media files" },
+    { "name": "wp_get_media", "description": "Get media details with all sizes" },
+    { "name": "wp_upload_media", "description": "Upload media from URL" },
+    { "name": "wp_list_categories", "description": "List categories with hierarchy and post count" },
+    { "name": "wp_list_tags", "description": "List tags with post count" },
+    { "name": "wp_create_taxonomy_term", "description": "Create a category or tag" },
+    { "name": "wp_list_comments", "description": "List comments with filters" },
+    { "name": "wp_create_comment", "description": "Create a comment or reply" },
+    { "name": "wp_list_post_types", "description": "Discover all registered post types (CPT)" },
+    { "name": "wp_list_custom_posts", "description": "List posts from any custom post type" },
+    { "name": "wp_list_users", "description": "List users with roles" },
+    { "name": "wp_set_target", "description": "Switch active WordPress site (multi-target mode)" },
+    { "name": "wp_site_info", "description": "Get site info, current user, post types, and enterprise controls" },
+    { "name": "wp_get_seo_meta", "description": "Get SEO metadata for a post or page" },
+    { "name": "wp_update_seo_meta", "description": "Update SEO metadata for a post or page" },
+    { "name": "wp_audit_seo", "description": "Audit SEO metadata across multiple posts/pages" },
+    { "name": "wp_list_plugins", "description": "List WordPress plugins with status filtering" },
+    { "name": "wp_activate_plugin", "description": "Activate a WordPress plugin" },
+    { "name": "wp_deactivate_plugin", "description": "Deactivate a WordPress plugin" },
+    { "name": "wp_list_themes", "description": "List installed WordPress themes" },
+    { "name": "wp_get_theme", "description": "Get details of a specific WordPress theme" },
+    { "name": "wp_list_revisions", "description": "List revisions of a post or page" },
+    { "name": "wp_get_revision", "description": "Get a specific revision with full content" },
+    { "name": "wp_restore_revision", "description": "Restore a post or page to a previous revision" },
+    { "name": "wp_delete_revision", "description": "Permanently delete a revision" }
+  ],
+  "keywords": [
+    "wordpress",
+    "cms",
+    "blog",
+    "posts",
+    "pages",
+    "media",
+    "seo",
+    "plugins",
+    "themes",
+    "rest-api"
+  ],
+  "license": "MIT",
+  "user_config": {
+    "wp_api_url": {
+      "type": "string",
+      "title": "WordPress Site URL",
+      "description": "Your WordPress site URL (e.g. https://yoursite.com)",
+      "required": true
+    },
+    "wp_api_username": {
+      "type": "string",
+      "title": "WordPress Username",
+      "description": "Your WordPress username",
+      "required": true
+    },
+    "wp_api_password": {
+      "type": "string",
+      "title": "WordPress Application Password",
+      "description": "Generate at WordPress Admin → Users → Profile → Application Passwords",
+      "sensitive": true,
+      "required": true
+    }
+  },
+  "compatibility": {
+    "claude_desktop": ">=0.10.0",
+    "platforms": ["darwin", "win32", "linux"],
+    "runtimes": {
+      "node": ">=18.0.0"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adsim/wordpress-mcp-server",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "A Model Context Protocol (MCP) server for WordPress REST API integration. Manage posts, search content, and interact with your WordPress site through any MCP-compatible client.",
   "type": "module",
   "main": "index.js",
@@ -12,7 +12,8 @@
     "start": "node index.js",
     "test": "vitest run",
     "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage"
+    "test:coverage": "vitest run --coverage",
+    "build:mcpb": "bash dxt/build-mcpb.sh"
   },
   "keywords": [
     "mcp",

package/tests/unit/dxt/manifest.test.js

@@ -0,0 +1,78 @@
+/**
+ * Tests for DXT manifest.json validation.
+ *
+ * Ensures the manifest conforms to MCPB specification v0.3.
+ */
+
+import { describe, it, expect } from 'vitest';
+import { readFileSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const manifestPath = resolve(__dirname, '../../../dxt/manifest.json');
+
+let manifest;
+
+describe('DXT manifest.json', () => {
+  it('is valid JSON', () => {
+    const raw = readFileSync(manifestPath, 'utf-8');
+    manifest = JSON.parse(raw);
+    expect(manifest).toBeDefined();
+  });
+
+  it('has required top-level fields', () => {
+    expect(manifest.manifest_version).toBe('0.3');
+    expect(typeof manifest.name).toBe('string');
+    expect(typeof manifest.version).toBe('string');
+    expect(typeof manifest.description).toBe('string');
+    expect(manifest.author).toBeDefined();
+    expect(typeof manifest.author.name).toBe('string');
+    expect(manifest.server).toBeDefined();
+  });
+
+  it('server.type is "node"', () => {
+    expect(manifest.server.type).toBe('node');
+  });
+
+  it('server.entry_point is set', () => {
+    expect(typeof manifest.server.entry_point).toBe('string');
+    expect(manifest.server.entry_point.length).toBeGreaterThan(0);
+  });
+
+  it('server.mcp_config.env maps WordPress credentials', () => {
+    const env = manifest.server.mcp_config.env;
+    expect(env.WP_API_URL).toBe('${user_config.wp_api_url}');
+    expect(env.WP_API_USERNAME).toBe('${user_config.wp_api_username}');
+    expect(env.WP_API_PASSWORD).toBe('${user_config.wp_api_password}');
+  });
+
+  it('user_config has wp_api_url, wp_api_username, wp_api_password', () => {
+    const cfg = manifest.user_config;
+    expect(cfg.wp_api_url).toBeDefined();
+    expect(cfg.wp_api_username).toBeDefined();
+    expect(cfg.wp_api_password).toBeDefined();
+  });
+
+  it('all user_config fields are required', () => {
+    expect(manifest.user_config.wp_api_url.required).toBe(true);
+    expect(manifest.user_config.wp_api_username.required).toBe(true);
+    expect(manifest.user_config.wp_api_password.required).toBe(true);
+  });
+
+  it('wp_api_password is marked as sensitive', () => {
+    expect(manifest.user_config.wp_api_password.sensitive).toBe(true);
+  });
+
+  it('declares at least 30 tools', () => {
+    expect(Array.isArray(manifest.tools)).toBe(true);
+    expect(manifest.tools.length).toBeGreaterThanOrEqual(30);
+  });
+
+  it('each tool has name and description', () => {
+    for (const tool of manifest.tools) {
+      expect(typeof tool.name).toBe('string');
+      expect(typeof tool.description).toBe('string');
+    }
+  });
+});