@adsim/wordpress-mcp-server 4.5.0 → 4.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adsim/wordpress-mcp-server",
-  "version": "4.5.0",
+  "version": "4.5.1",
   "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",

package/tests/unit/tools/dynamicFiltering.test.js

@@ -0,0 +1,136 @@
+import { vi, describe, it, expect, beforeEach, afterEach } from 'vitest';
+
+vi.mock('node-fetch', () => ({ default: vi.fn() }));
+
+import fetch from 'node-fetch';
+import { handleToolCall, getFilteredTools } from '../../../index.js';
+import { makeRequest, mockSuccess, mockError, parseResult } from '../../helpers/mockWpRequest.js';
+
+function call(name, args = {}) {
+  return handleToolCall(makeRequest(name, args));
+}
+
+let consoleSpy;
+const envBackup = {};
+
+function saveEnv(...keys) {
+  keys.forEach(k => { envBackup[k] = process.env[k]; });
+}
+function restoreEnv() {
+  Object.entries(envBackup).forEach(([k, v]) => {
+    if (v === undefined) delete process.env[k];
+    else process.env[k] = v;
+  });
+}
+
+beforeEach(() => {
+  fetch.mockReset();
+  consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
+  saveEnv('WC_CONSUMER_KEY', 'WP_REQUIRE_APPROVAL', 'WP_ENABLE_PLUGIN_INTELLIGENCE');
+  // Default: all optional features OFF
+  delete process.env.WC_CONSUMER_KEY;
+  delete process.env.WP_REQUIRE_APPROVAL;
+  delete process.env.WP_ENABLE_PLUGIN_INTELLIGENCE;
+});
+afterEach(() => {
+  consoleSpy.mockRestore();
+  restoreEnv();
+});
+
+// =========================================================================
+// WooCommerce filtering
+// =========================================================================
+
+describe('WooCommerce filtering', () => {
+  it('hides WooCommerce tools when WC_CONSUMER_KEY absent', () => {
+    const tools = getFilteredTools();
+    const wcTools = tools.filter(t => t.name.startsWith('wc_'));
+    expect(wcTools).toHaveLength(0);
+  });
+
+  it('shows WooCommerce tools when WC_CONSUMER_KEY set', () => {
+    process.env.WC_CONSUMER_KEY = 'ck_test';
+    const tools = getFilteredTools();
+    const wcTools = tools.filter(t => t.name.startsWith('wc_'));
+    expect(wcTools.length).toBe(13);
+  });
+});
+
+// =========================================================================
+// Editorial workflow filtering
+// =========================================================================
+
+describe('Editorial workflow filtering', () => {
+  it('hides editorial tools when WP_REQUIRE_APPROVAL not true', () => {
+    const tools = getFilteredTools();
+    const names = tools.map(t => t.name);
+    expect(names).not.toContain('wp_submit_for_review');
+    expect(names).not.toContain('wp_approve_post');
+    expect(names).not.toContain('wp_reject_post');
+  });
+
+  it('shows editorial tools when WP_REQUIRE_APPROVAL=true', () => {
+    process.env.WP_REQUIRE_APPROVAL = 'true';
+    const tools = getFilteredTools();
+    const names = tools.map(t => t.name);
+    expect(names).toContain('wp_submit_for_review');
+    expect(names).toContain('wp_approve_post');
+    expect(names).toContain('wp_reject_post');
+  });
+});
+
+// =========================================================================
+// Plugin Intelligence filtering
+// =========================================================================
+
+describe('Plugin Intelligence filtering', () => {
+  it('hides Plugin Intelligence when WP_ENABLE_PLUGIN_INTELLIGENCE not true', () => {
+    const tools = getFilteredTools();
+    const names = tools.map(t => t.name);
+    expect(names).not.toContain('wp_get_rendered_head');
+    expect(names).not.toContain('wp_audit_schema_plugins');
+    expect(names).not.toContain('wp_get_twitter_meta');
+  });
+
+  it('shows Plugin Intelligence when WP_ENABLE_PLUGIN_INTELLIGENCE=true', () => {
+    process.env.WP_ENABLE_PLUGIN_INTELLIGENCE = 'true';
+    const tools = getFilteredTools();
+    const piNames = ['wp_get_rendered_head', 'wp_audit_rendered_seo', 'wp_get_pillar_content', 'wp_audit_schema_plugins', 'wp_get_seo_score', 'wp_get_twitter_meta'];
+    const names = tools.map(t => t.name);
+    piNames.forEach(n => expect(names).toContain(n));
+  });
+});
+
+// =========================================================================
+// Combined counts
+// =========================================================================
+
+describe('Combined filtering counts', () => {
+  it('returns all 85 tools when all features enabled', () => {
+    process.env.WC_CONSUMER_KEY = 'ck_test';
+    process.env.WP_REQUIRE_APPROVAL = 'true';
+    process.env.WP_ENABLE_PLUGIN_INTELLIGENCE = 'true';
+    expect(getFilteredTools()).toHaveLength(85);
+  });
+
+  it('returns 63 tools with no optional features (85 - 13wc - 3editorial - 6pi)', () => {
+    expect(getFilteredTools()).toHaveLength(63);
+  });
+});
+
+// =========================================================================
+// handleToolCall still works for filtered-out tools
+// =========================================================================
+
+describe('Filtered tools remain callable', () => {
+  it('handleToolCall works for a filtered-out WooCommerce tool (wc_list_products)', async () => {
+    // WC_CONSUMER_KEY is absent, so wc_list_products is filtered from listTools
+    const names = getFilteredTools().map(t => t.name);
+    expect(names).not.toContain('wc_list_products');
+
+    // But calling it directly should NOT throw "Unknown tool"
+    // It will fail with a WooCommerce credentials error, which is fine
+    const res = await call('wc_list_products');
+    expect(res.content[0].text).not.toContain('Unknown tool');
+  });
+});

package/tests/unit/tools/outputCompression.test.js

@@ -0,0 +1,342 @@
+import { vi, describe, it, expect, beforeEach, afterEach } from 'vitest';
+
+vi.mock('node-fetch', () => ({ default: vi.fn() }));
+
+import fetch from 'node-fetch';
+import { handleToolCall } from '../../../index.js';
+import { mockSuccess, makeRequest, parseResult } from '../../helpers/mockWpRequest.js';
+
+function call(name, args = {}) {
+  return handleToolCall(makeRequest(name, args));
+}
+
+let consoleSpy;
+beforeEach(() => { fetch.mockReset(); consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => {}); });
+afterEach(() => { consoleSpy.mockRestore(); });
+
+// ── Mock data factories ──
+
+const mockPage = { id: 10, title: { rendered: 'About' }, slug: 'about', status: 'publish', date: '2024-01-01', link: 'https://test.example.com/about', parent: 0, menu_order: 1, template: '', excerpt: { rendered: 'About page' } };
+
+const mockMedia = { id: 1, title: { rendered: 'Logo' }, date: '2024-01-01', mime_type: 'image/png', source_url: 'https://test.example.com/logo.png', alt_text: 'Site logo', media_details: { width: 200, height: 100 } };
+
+const mockComment = { id: 100, post: 5, parent: 0, author_name: 'Alice', date: '2024-02-01', status: 'approved', content: { rendered: '<p>Great post!</p>' }, link: 'https://test.example.com/post#comment-100' };
+
+const mockCategory = { id: 5, name: 'Tech', slug: 'tech', description: 'Tech articles', parent: 0, count: 12 };
+
+const mockTag = { id: 7, name: 'javascript', slug: 'javascript', count: 8 };
+
+const mockUser = { id: 1, name: 'Admin', slug: 'admin', link: 'https://test.example.com/author/admin', roles: ['administrator'], avatar_urls: { '96': 'https://test.example.com/avatar.jpg' } };
+
+const mockCustomPost = { id: 42, title: { rendered: 'Portfolio Item' }, slug: 'portfolio-item', status: 'publish', date: '2024-03-01', link: 'https://test.example.com/portfolio/portfolio-item', type: 'portfolio', meta: {} };
+
+const mockPlugin = { plugin: 'akismet/akismet.php', name: 'Akismet', version: '5.3', status: 'active', author: { rendered: 'Automattic' }, description: { rendered: 'Anti-spam' }, plugin_uri: 'https://akismet.com', requires_wp: '6.0', requires_php: '7.4', network_only: false, textdomain: 'akismet' };
+
+const mockTheme = { stylesheet: 'twentytwentyfour', template: 'twentytwentyfour', name: { rendered: 'Twenty Twenty-Four' }, description: { rendered: 'Default theme' }, status: 'active', version: '1.2', author: { rendered: 'WordPress' }, author_uri: '', theme_uri: '', requires_wp: '6.4', requires_php: '7.0', tags: { rendered: ['blog'] } };
+
+const mockRevision = { id: 200, parent: 5, date: '2024-04-01', date_gmt: '2024-04-01T00:00:00', modified: '2024-04-01', modified_gmt: '2024-04-01T00:00:00', author: 1, title: { rendered: 'Draft v2' }, excerpt: { rendered: 'Updated excerpt' }, slug: '5-revision-v1' };
+
+const mockTypes = { portfolio: { slug: 'portfolio', name: 'Portfolio', rest_base: 'portfolio' } };
+
+// =========================================================================
+// wp_list_pages
+// =========================================================================
+
+describe('wp_list_pages — output compression', () => {
+  it('mode=ids_only returns flat ID array', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockPage]));
+    const data = parseResult(await call('wp_list_pages', { mode: 'ids_only' }));
+    expect(data.mode).toBe('ids_only');
+    expect(data.ids).toEqual([10]);
+    expect(data.pages).toBeUndefined();
+  });
+
+  it('mode=summary returns compact object with expected keys', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockPage]));
+    const data = parseResult(await call('wp_list_pages', { mode: 'summary' }));
+    expect(data.mode).toBe('summary');
+    expect(data.pages[0]).toEqual({ id: 10, title: 'About', slug: 'about', status: 'publish', link: 'https://test.example.com/about', parent: 0 });
+    expect(data.pages[0].menu_order).toBeUndefined();
+  });
+
+  it('mode=full (default) returns full format', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockPage]));
+    const data = parseResult(await call('wp_list_pages'));
+    expect(data.mode).toBeUndefined();
+    expect(data.pages[0].menu_order).toBe(1);
+    expect(data.pages[0].template).toBe('');
+  });
+});
+
+// =========================================================================
+// wp_list_media
+// =========================================================================
+
+describe('wp_list_media — output compression', () => {
+  it('mode=ids_only returns flat ID array', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockMedia]));
+    const data = parseResult(await call('wp_list_media', { mode: 'ids_only' }));
+    expect(data.mode).toBe('ids_only');
+    expect(data.ids).toEqual([1]);
+    expect(data.media).toBeUndefined();
+  });
+
+  it('mode=summary returns compact object with expected keys', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockMedia]));
+    const data = parseResult(await call('wp_list_media', { mode: 'summary' }));
+    expect(data.mode).toBe('summary');
+    expect(data.media[0]).toEqual({ id: 1, title: 'Logo', mime_type: 'image/png', source_url: 'https://test.example.com/logo.png', alt_text: 'Site logo' });
+    expect(data.media[0].width).toBeUndefined();
+  });
+
+  it('mode=full (default) returns full format', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockMedia]));
+    const data = parseResult(await call('wp_list_media'));
+    expect(data.mode).toBeUndefined();
+    expect(data.media[0].width).toBe(200);
+    expect(data.media[0].height).toBe(100);
+  });
+});
+
+// =========================================================================
+// wp_list_comments
+// =========================================================================
+
+describe('wp_list_comments — output compression', () => {
+  it('mode=ids_only returns flat ID array', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockComment]));
+    const data = parseResult(await call('wp_list_comments', { mode: 'ids_only' }));
+    expect(data.mode).toBe('ids_only');
+    expect(data.ids).toEqual([100]);
+    expect(data.comments).toBeUndefined();
+  });
+
+  it('mode=summary returns compact object with expected keys', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockComment]));
+    const data = parseResult(await call('wp_list_comments', { mode: 'summary' }));
+    expect(data.mode).toBe('summary');
+    expect(data.comments[0]).toEqual({ id: 100, post: 5, author_name: 'Alice', date: '2024-02-01', status: 'approved' });
+    expect(data.comments[0].content).toBeUndefined();
+  });
+
+  it('mode=full (default) returns full format', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockComment]));
+    const data = parseResult(await call('wp_list_comments'));
+    expect(data.mode).toBeUndefined();
+    expect(data.comments[0].content).toBeDefined();
+    expect(data.comments[0].link).toBeDefined();
+  });
+});
+
+// =========================================================================
+// wp_list_categories
+// =========================================================================
+
+describe('wp_list_categories — output compression', () => {
+  it('mode=ids_only returns flat ID array', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockCategory]));
+    const data = parseResult(await call('wp_list_categories', { mode: 'ids_only' }));
+    expect(data.mode).toBe('ids_only');
+    expect(data.ids).toEqual([5]);
+    expect(data.categories).toBeUndefined();
+  });
+
+  it('mode=summary returns compact object with expected keys', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockCategory]));
+    const data = parseResult(await call('wp_list_categories', { mode: 'summary' }));
+    expect(data.mode).toBe('summary');
+    expect(data.categories[0]).toEqual({ id: 5, name: 'Tech', slug: 'tech', count: 12, parent: 0 });
+    expect(data.categories[0].description).toBeUndefined();
+  });
+
+  it('mode=full (default) returns full format', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockCategory]));
+    const data = parseResult(await call('wp_list_categories'));
+    expect(data.mode).toBeUndefined();
+    expect(data.categories[0].description).toBe('Tech articles');
+  });
+});
+
+// =========================================================================
+// wp_list_tags
+// =========================================================================
+
+describe('wp_list_tags — output compression', () => {
+  it('mode=ids_only returns flat ID array', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockTag]));
+    const data = parseResult(await call('wp_list_tags', { mode: 'ids_only' }));
+    expect(data.mode).toBe('ids_only');
+    expect(data.ids).toEqual([7]);
+    expect(data.tags).toBeUndefined();
+  });
+
+  it('mode=summary returns compact object with expected keys', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockTag]));
+    const data = parseResult(await call('wp_list_tags', { mode: 'summary' }));
+    expect(data.mode).toBe('summary');
+    expect(data.tags[0]).toEqual({ id: 7, name: 'javascript', slug: 'javascript', count: 8 });
+  });
+
+  it('mode=full (default) returns full format', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockTag]));
+    const data = parseResult(await call('wp_list_tags'));
+    expect(data.mode).toBeUndefined();
+    expect(data.tags[0].id).toBe(7);
+    expect(data.tags[0].count).toBe(8);
+  });
+});
+
+// =========================================================================
+// wp_list_users
+// =========================================================================
+
+describe('wp_list_users — output compression', () => {
+  it('mode=ids_only returns flat ID array', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockUser]));
+    const data = parseResult(await call('wp_list_users', { mode: 'ids_only' }));
+    expect(data.mode).toBe('ids_only');
+    expect(data.ids).toEqual([1]);
+    expect(data.users).toBeUndefined();
+  });
+
+  it('mode=summary returns compact object with expected keys', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockUser]));
+    const data = parseResult(await call('wp_list_users', { mode: 'summary' }));
+    expect(data.mode).toBe('summary');
+    expect(data.users[0]).toEqual({ id: 1, name: 'Admin', slug: 'admin', roles: ['administrator'] });
+    expect(data.users[0].avatar).toBeUndefined();
+  });
+
+  it('mode=full (default) returns full format', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockUser]));
+    const data = parseResult(await call('wp_list_users'));
+    expect(data.mode).toBeUndefined();
+    expect(data.users[0].link).toBeDefined();
+    expect(data.users[0].avatar).toBeDefined();
+  });
+});
+
+// =========================================================================
+// wp_list_custom_posts
+// =========================================================================
+
+describe('wp_list_custom_posts — output compression', () => {
+  it('mode=ids_only returns flat ID array', async () => {
+    mockSuccess(mockTypes);
+    mockSuccess([mockCustomPost]);
+    const data = parseResult(await call('wp_list_custom_posts', { post_type: 'portfolio', mode: 'ids_only' }));
+    expect(data.mode).toBe('ids_only');
+    expect(data.ids).toEqual([42]);
+    expect(data.posts).toBeUndefined();
+  });
+
+  it('mode=summary returns compact object with expected keys', async () => {
+    mockSuccess(mockTypes);
+    mockSuccess([mockCustomPost]);
+    const data = parseResult(await call('wp_list_custom_posts', { post_type: 'portfolio', mode: 'summary' }));
+    expect(data.mode).toBe('summary');
+    expect(data.posts[0]).toEqual({ id: 42, title: 'Portfolio Item', slug: 'portfolio-item', date: '2024-03-01', status: 'publish', link: 'https://test.example.com/portfolio/portfolio-item' });
+    expect(data.posts[0].type).toBeUndefined();
+  });
+
+  it('mode=full (default) returns full format', async () => {
+    mockSuccess(mockTypes);
+    mockSuccess([mockCustomPost]);
+    const data = parseResult(await call('wp_list_custom_posts', { post_type: 'portfolio' }));
+    expect(data.mode).toBeUndefined();
+    expect(data.posts[0].type).toBe('portfolio');
+    expect(data.posts[0].meta).toEqual({});
+  });
+});
+
+// =========================================================================
+// wp_list_plugins
+// =========================================================================
+
+describe('wp_list_plugins — output compression', () => {
+  it('mode=ids_only returns flat plugin slug array', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockPlugin]));
+    const data = parseResult(await call('wp_list_plugins', { mode: 'ids_only' }));
+    expect(data.mode).toBe('ids_only');
+    expect(data.ids).toEqual(['akismet/akismet.php']);
+    expect(data.plugins).toBeUndefined();
+  });
+
+  it('mode=summary returns compact object with expected keys', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockPlugin]));
+    const data = parseResult(await call('wp_list_plugins', { mode: 'summary' }));
+    expect(data.mode).toBe('summary');
+    expect(data.plugins[0]).toEqual({ plugin: 'akismet/akismet.php', name: 'Akismet', status: 'active', version: '5.3' });
+    expect(data.plugins[0].author).toBeUndefined();
+  });
+
+  it('mode=full (default) returns full format', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockPlugin]));
+    const data = parseResult(await call('wp_list_plugins'));
+    expect(data.mode).toBeUndefined();
+    expect(data.active).toBe(1);
+    expect(data.inactive).toBe(0);
+    expect(data.plugins[0].author).toBeDefined();
+  });
+});
+
+// =========================================================================
+// wp_list_themes
+// =========================================================================
+
+describe('wp_list_themes — output compression', () => {
+  it('mode=ids_only returns flat stylesheet array', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockTheme]));
+    const data = parseResult(await call('wp_list_themes', { mode: 'ids_only' }));
+    expect(data.mode).toBe('ids_only');
+    expect(data.ids).toEqual(['twentytwentyfour']);
+    expect(data.themes).toBeUndefined();
+  });
+
+  it('mode=summary returns compact object with expected keys', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockTheme]));
+    const data = parseResult(await call('wp_list_themes', { mode: 'summary' }));
+    expect(data.mode).toBe('summary');
+    expect(data.themes[0]).toEqual({ stylesheet: 'twentytwentyfour', name: 'Twenty Twenty-Four', status: 'active', version: '1.2' });
+    expect(data.themes[0].author).toBeUndefined();
+  });
+
+  it('mode=full (default) returns full format', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockTheme]));
+    const data = parseResult(await call('wp_list_themes'));
+    expect(data.mode).toBeUndefined();
+    expect(data.active_theme).toBe('Twenty Twenty-Four');
+    expect(data.themes[0].author).toBeDefined();
+  });
+});
+
+// =========================================================================
+// wp_list_revisions
+// =========================================================================
+
+describe('wp_list_revisions — output compression', () => {
+  it('mode=ids_only returns flat ID array', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockRevision]));
+    const data = parseResult(await call('wp_list_revisions', { post_id: 5, mode: 'ids_only' }));
+    expect(data.mode).toBe('ids_only');
+    expect(data.ids).toEqual([200]);
+    expect(data.revisions).toBeUndefined();
+  });
+
+  it('mode=summary returns compact object with expected keys', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockRevision]));
+    const data = parseResult(await call('wp_list_revisions', { post_id: 5, mode: 'summary' }));
+    expect(data.mode).toBe('summary');
+    expect(data.revisions[0]).toEqual({ id: 200, date: '2024-04-01', author: 1 });
+    expect(data.revisions[0].slug).toBeUndefined();
+  });
+
+  it('mode=full (default) returns full format', async () => {
+    fetch.mockResolvedValue(mockSuccess([mockRevision]));
+    const data = parseResult(await call('wp_list_revisions', { post_id: 5 }));
+    expect(data.mode).toBeUndefined();
+    expect(data.note).toBeDefined();
+    expect(data.revisions[0].slug).toBe('5-revision-v1');
+    expect(data.revisions[0].author).toBe(1);
+  });
+});

package/tests/unit/tools/site.test.js

@@ -80,7 +80,9 @@ describe('wp_site_info', () => {
 
     // Server info
     expect(data.server.mcp_version).toBeDefined();
-    expect(data.server.tools_count).toBe(85);
+    expect(data.server.tools_total).toBe(85);
+    expect(typeof data.server.tools_exposed).toBe('number');
+    expect(Array.isArray(data.server.filtered_out)).toBe(true);
   });
 
   it('SUCCESS — enterprise_controls reflect WP_READ_ONLY env var', async () => {