fa-mcp-sdk 0.4.3 → 0.4.6

package/src/tests/mcp/test-cases.js

@@ -1,143 +1,143 @@
-#!/usr/bin/env node
-
-/**
- * Shared test cases for the template MCP server (src/template)
- * Covers: prompts, resources, tools
- *
- * Each test case is a function(client) -> Promise<{ name, passed, details? }>
- * where client provides methods:
- *   - listPrompts(), getPrompt(name, args?)
- *   - listResources(), readResource(uri)
- *   - listTools(), callTool(name, args?)
- */
-
-const ok = (name, details) => ({ name, passed: true, details });
-const fail = (name, details) => ({ name, passed: false, details });
-
-// Utility: extract system text from prompts/get response
-const extractPromptText = (resp) => {
-  // resp may be raw result or wrapped; support both shapes used by clients
-  const r = resp?.result || resp;
-  const msg = r?.messages?.[0];
-  const text = msg?.content?.text || msg?.content?.[0]?.text || r?.messages?.[0]?.content?.[0]?.text;
-  return typeof text === 'string' ? text : undefined;
-};
-
-export const TEMPLATE_TESTS = {
-  prompts: [
-    async (client) => {
-      const name = 'List prompts contains agent_brief and agent_prompt';
-      try {
-        const list = await client.listPrompts();
-        const prompts = list?.prompts || list;
-        const names = Array.isArray(prompts) ? prompts.map(p => p.name) : [];
-        const okBrief = names.includes('agent_brief');
-        const okPrompt = names.includes('agent_prompt');
-        return (okBrief && okPrompt) ? ok(name, { names }) : fail(name, { names });
-      } catch (e) {
-        return fail(name, { error: e?.message });
-      }
-    },
-    async (client) => {
-      const name = 'Get agent_brief returns text';
-      try {
-        const resp = await client.getPrompt('agent_brief');
-        const text = extractPromptText(resp);
-        return text ? ok(name, { text }) : fail(name, { text });
-      } catch (e) {
-        return fail(name, { error: e?.message });
-      }
-    },
-    async (client) => {
-      const name = 'Get agent_prompt returns text';
-      try {
-        const resp = await client.getPrompt('agent_prompt');
-        const text = extractPromptText(resp);
-        return text ? ok(name, { text }) : fail(name, { text });
-      } catch (e) {
-        return fail(name, { error: e?.message });
-      }
-    },
-    async (client) => {
-      const name = 'Get custom_prompt returns dynamic text';
-      try {
-        const resp = await client.getPrompt('custom_prompt', { sample: '1' });
-        const text = extractPromptText(resp);
-        const hasWord = typeof text === 'string' && text.includes('Custom prompt content');
-        return hasWord ? ok(name, { text }) : fail(name, { text });
-      } catch (e) {
-        return fail(name, { error: e?.message });
-      }
-    },
-  ],
-
-  resources: [
-    async (client) => {
-      const name = 'List resources contains custom-resource://resource1';
-      try {
-        const list = await client.listResources();
-        const resources = list?.resources || list;
-        const uris = Array.isArray(resources) ? resources.map(r => r.uri) : [];
-        const found = uris.includes('custom-resource://resource1');
-        return found ? ok(name, { uris }) : fail(name, { uris });
-      } catch (e) {
-        return fail(name, { error: e?.message });
-      }
-    },
-    async (client) => {
-      const name = 'Read resource custom-resource://resource1 returns content';
-      try {
-        const resp = await client.readResource('custom-resource://resource1');
-        // Different clients return differently; normalize
-        const r = resp?.result || resp;
-        const text = r?.resource?.text || r?.contents?.[0]?.text || r?.text || r?.resource?.content;
-        const okText = typeof text === 'string' && text.length > 0;
-        return okText ? ok(name, { text }) : fail(name, { response: r });
-      } catch (e) {
-        return fail(name, { error: e?.message });
-      }
-    },
-  ],
-
-  tools: [
-    async (client) => {
-      const name = 'List tools contains example_tool and example_search';
-      try {
-        const list = await client.listTools();
-        const tools = list?.tools || list;
-        const names = Array.isArray(tools) ? tools.map(t => t.name) : [];
-        const ok1 = names.includes('example_tool');
-        const ok2 = names.includes('example_search');
-        return (ok1 && ok2) ? ok(name, { names }) : fail(name, { names });
-      } catch (e) {
-        return fail(name, { error: e?.message });
-      }
-    },
-    async (client) => {
-      const name = 'Call example_tool returns formatted result';
-      try {
-        const resp = await client.callTool('example_tool', { query: 'ping' });
-        const r = resp?.result || resp;
-        // Both structuredContent and text are acceptable; check message echo
-        const structured = r?.structuredContent;
-        const text = r?.content?.[0]?.text;
-        const hasProcessed = (structured && structured.message?.includes('Processed query'))
-          || (typeof text === 'string' && text.includes('Processed query'));
-        return hasProcessed ? ok(name, { response: r }) : fail(name, { response: r });
-      } catch (e) {
-        return fail(name, { error: e?.message });
-      }
-    },
-    async (client) => {
-      const name = 'Call example_tool without query should fail';
-      try {
-        await client.callTool('example_tool', {});
-        return fail(name, { error: 'Expected failure, got success' });
-      } catch (e) {
-        return ok(name, { error: e?.message });
-      }
-    },
-  ],
-};
-
-export default TEMPLATE_TESTS;
+#!/usr/bin/env node
+
+/**
+ * Shared test cases for the template MCP server (src/template)
+ * Covers: prompts, resources, tools
+ *
+ * Each test case is a function(client) -> Promise<{ name, passed, details? }>
+ * where client provides methods:
+ *   - listPrompts(), getPrompt(name, args?)
+ *   - listResources(), readResource(uri)
+ *   - listTools(), callTool(name, args?)
+ */
+
+const ok = (name, details) => ({ name, passed: true, details });
+const fail = (name, details) => ({ name, passed: false, details });
+
+// Utility: extract system text from prompts/get response
+const extractPromptText = (resp) => {
+  // resp may be raw result or wrapped; support both shapes used by clients
+  const r = resp?.result || resp;
+  const msg = r?.messages?.[0];
+  const text = msg?.content?.text || msg?.content?.[0]?.text || r?.messages?.[0]?.content?.[0]?.text;
+  return typeof text === 'string' ? text : undefined;
+};
+
+export const TEMPLATE_TESTS = {
+  prompts: [
+    async (client) => {
+      const name = 'List prompts contains agent_brief and agent_prompt';
+      try {
+        const list = await client.listPrompts();
+        const prompts = list?.prompts || list;
+        const names = Array.isArray(prompts) ? prompts.map(p => p.name) : [];
+        const okBrief = names.includes('agent_brief');
+        const okPrompt = names.includes('agent_prompt');
+        return (okBrief && okPrompt) ? ok(name, { names }) : fail(name, { names });
+      } catch (e) {
+        return fail(name, { error: e?.message });
+      }
+    },
+    async (client) => {
+      const name = 'Get agent_brief returns text';
+      try {
+        const resp = await client.getPrompt('agent_brief');
+        const text = extractPromptText(resp);
+        return text ? ok(name, { text }) : fail(name, { text });
+      } catch (e) {
+        return fail(name, { error: e?.message });
+      }
+    },
+    async (client) => {
+      const name = 'Get agent_prompt returns text';
+      try {
+        const resp = await client.getPrompt('agent_prompt');
+        const text = extractPromptText(resp);
+        return text ? ok(name, { text }) : fail(name, { text });
+      } catch (e) {
+        return fail(name, { error: e?.message });
+      }
+    },
+    async (client) => {
+      const name = 'Get custom_prompt returns dynamic text';
+      try {
+        const resp = await client.getPrompt('custom_prompt', { sample: '1' });
+        const text = extractPromptText(resp);
+        const hasWord = typeof text === 'string' && text.includes('Custom prompt content');
+        return hasWord ? ok(name, { text }) : fail(name, { text });
+      } catch (e) {
+        return fail(name, { error: e?.message });
+      }
+    },
+  ],
+
+  resources: [
+    async (client) => {
+      const name = 'List resources contains custom-resource://resource1';
+      try {
+        const list = await client.listResources();
+        const resources = list?.resources || list;
+        const uris = Array.isArray(resources) ? resources.map(r => r.uri) : [];
+        const found = uris.includes('custom-resource://resource1');
+        return found ? ok(name, { uris }) : fail(name, { uris });
+      } catch (e) {
+        return fail(name, { error: e?.message });
+      }
+    },
+    async (client) => {
+      const name = 'Read resource custom-resource://resource1 returns content';
+      try {
+        const resp = await client.readResource('custom-resource://resource1');
+        // Different clients return differently; normalize
+        const r = resp?.result || resp;
+        const text = r?.resource?.text || r?.contents?.[0]?.text || r?.text || r?.resource?.content;
+        const okText = typeof text === 'string' && text.length > 0;
+        return okText ? ok(name, { text }) : fail(name, { response: r });
+      } catch (e) {
+        return fail(name, { error: e?.message });
+      }
+    },
+  ],
+
+  tools: [
+    async (client) => {
+      const name = 'List tools contains example_tool and example_search';
+      try {
+        const list = await client.listTools();
+        const tools = list?.tools || list;
+        const names = Array.isArray(tools) ? tools.map(t => t.name) : [];
+        const ok1 = names.includes('example_tool');
+        const ok2 = names.includes('example_search');
+        return (ok1 && ok2) ? ok(name, { names }) : fail(name, { names });
+      } catch (e) {
+        return fail(name, { error: e?.message });
+      }
+    },
+    async (client) => {
+      const name = 'Call example_tool returns formatted result';
+      try {
+        const resp = await client.callTool('example_tool', { query: 'ping' });
+        const r = resp?.result || resp;
+        // Both structuredContent and text are acceptable; check message echo
+        const structured = r?.structuredContent;
+        const text = r?.content?.[0]?.text;
+        const hasProcessed = (structured && structured.message?.includes('Processed query'))
+          || (typeof text === 'string' && text.includes('Processed query'));
+        return hasProcessed ? ok(name, { response: r }) : fail(name, { response: r });
+      } catch (e) {
+        return fail(name, { error: e?.message });
+      }
+    },
+    async (client) => {
+      const name = 'Call example_tool without query should fail';
+      try {
+        await client.callTool('example_tool', {});
+        return fail(name, { error: 'Expected failure, got success' });
+      } catch (e) {
+        return ok(name, { error: e?.message });
+      }
+    },
+  ],
+};
+
+export default TEMPLATE_TESTS;

package/src/tests/mcp/test-http.js

@@ -1,75 +1,76 @@
-#!/usr/bin/env node
-
-/**
- * HTTP transport tests for the template MCP server (src/template)
- * Uses McpHttpClient (simple POST requests)
- */
-
-import { appConfig, McpHttpClient, getAuthHeadersForTests } from '../../../dist/core/index.js';
-import TEMPLATE_TESTS from './test-cases.js';
-
-const baseUrl = (process.env.TEST_MCP_SERVER_URL || `http://localhost:${appConfig.webServer.port}`).replace(/\/+$/, '');
-
-async function runTestGroup (title, tests, client) {
-  console.log(`\n${title}:`);
-  let passed = 0;
-  for (const test of tests) {
-    try {
-      const res = await test(client);
-      if (res.passed) {
-        console.log(`  ✅  ${res.name}`);
-        passed++;
-      } else {
-        console.log(`  ❌  ${res.name}`);
-        if (res.details) {
-          console.log('     ', res.details);
-        }
-      }
-    } catch (e) {
-      console.log(`  ❌  ${(await test).name || 'test'}:`, e.message);
-    }
-  }
-  console.log(`  Result: ${passed}/${tests.length} passed`);
-  return passed;
-}
-
-async function main () {
-  console.log('🧪 HTTP tests for template MCP server');
-  console.log('='.repeat(60));
-
-  // Get authentication headers based on config
-  const headers = getAuthHeadersForTests();
-  if (Object.keys(headers).length) {
-    console.log('  Authentication enabled');
-  } else if (appConfig.webServer?.auth?.enabled) {
-    console.log('⚠️  Warning: Auth is enabled but no valid credentials found');
-  }
-
-  const client = new McpHttpClient(baseUrl, { headers });
-  try {
-    await client.initialize({
-      protocolVersion: '2024-11-05',
-      capabilities: { tools: {} },
-      clientInfo: { name: 'http-test', version: '1.0.0' },
-    });
-
-    const p1 = await runTestGroup('Prompts', TEMPLATE_TESTS.prompts, client);
-    const p2 = await runTestGroup('Resources', TEMPLATE_TESTS.resources, client);
-    const p3 = await runTestGroup('Tools', TEMPLATE_TESTS.tools, client);
-
-    const total = TEMPLATE_TESTS.prompts.length + TEMPLATE_TESTS.resources.length + TEMPLATE_TESTS.tools.length;
-    const sum = p1 + p2 + p3;
-    console.log(`\nSummary: ${sum}/${total} tests passed`);
-  } finally {
-    await client.close().catch(() => undefined);
-  }
-}
-
-main()
-  .then(() => {
-    process.exit(0);
-  })
-  .catch((e) => {
-    console.error('Test failed:', e?.message || e);
-    process.exit(1);
-  });
+#!/usr/bin/env node
+
+/**
+ * HTTP transport tests for the template MCP server (src/template)
+ * Uses McpHttpClient (simple POST requests)
+ */
+
+import { appConfig, McpHttpClient, getAuthHeadersForTests } from '../../../dist/core/index.js';
+
+import TEMPLATE_TESTS from './test-cases.js';
+
+const baseUrl = (process.env.TEST_MCP_SERVER_URL || `http://localhost:${appConfig.webServer.port}`).replace(/\/+$/, '');
+
+async function runTestGroup (title, tests, client) {
+  console.log(`\n${title}:`);
+  let passed = 0;
+  for (const test of tests) {
+    try {
+      const res = await test(client);
+      if (res.passed) {
+        console.log(`  ✅  ${res.name}`);
+        passed++;
+      } else {
+        console.log(`  ❌  ${res.name}`);
+        if (res.details) {
+          console.log('     ', res.details);
+        }
+      }
+    } catch (e) {
+      console.log(`  ❌  ${(await test).name || 'test'}:`, e.message);
+    }
+  }
+  console.log(`  Result: ${passed}/${tests.length} passed`);
+  return passed;
+}
+
+async function main () {
+  console.log('🧪 HTTP tests for template MCP server');
+  console.log('='.repeat(60));
+
+  // Get authentication headers based on config
+  const headers = getAuthHeadersForTests();
+  if (Object.keys(headers).length) {
+    console.log('  Authentication enabled');
+  } else if (appConfig.webServer?.auth?.enabled) {
+    console.log('⚠️  Warning: Auth is enabled but no valid credentials found');
+  }
+
+  const client = new McpHttpClient(baseUrl, { headers });
+  try {
+    await client.initialize({
+      protocolVersion: '2024-11-05',
+      capabilities: { tools: {} },
+      clientInfo: { name: 'http-test', version: '1.0.0' },
+    });
+
+    const p1 = await runTestGroup('Prompts', TEMPLATE_TESTS.prompts, client);
+    const p2 = await runTestGroup('Resources', TEMPLATE_TESTS.resources, client);
+    const p3 = await runTestGroup('Tools', TEMPLATE_TESTS.tools, client);
+
+    const total = TEMPLATE_TESTS.prompts.length + TEMPLATE_TESTS.resources.length + TEMPLATE_TESTS.tools.length;
+    const sum = p1 + p2 + p3;
+    console.log(`\nSummary: ${sum}/${total} tests passed`);
+  } finally {
+    await client.close().catch(() => undefined);
+  }
+}
+
+main()
+  .then(() => {
+    process.exit(0);
+  })
+  .catch((e) => {
+    console.error('Test failed:', e?.message || e);
+    process.exit(1);
+  });

package/src/tests/mcp/test-sse.js

@@ -1,79 +1,80 @@
-#!/usr/bin/env node
-
-/**
- * SSE transport tests for the template MCP server (src/template)
- * Uses McpSseClient to send requests via HTTP and receive responses via SSE
- */
-
-import { appConfig, McpSseClient, getAuthHeadersForTests } from '../../../dist/core/index.js';
-import TEMPLATE_TESTS from './test-cases.js';
-
-const baseUrl = (process.env.TEST_MCP_SERVER_URL || `http://localhost:${appConfig.webServer.port}`).replace(/\/+$/, '');
-
-async function runTestGroup (title, tests, client) {
-  console.log(`\n${title}:`);
-  let passed = 0;
-  for (const test of tests) {
-    try {
-      const res = await test(client);
-      if (res.passed) {
-        console.log(`  ✅  ${res.name}`);
-        passed++;
-      } else {
-        console.log(`  ❌  ${res.name}`);
-        if (res.details) {
-          console.log('     ', res.details);
-        }
-      }
-    } catch (e) {
-      console.log(`  ❌  ${test.name || 'test'}:`, e.message);
-    }
-  }
-  console.log(`  Result: ${passed}/${tests.length} passed`);
-  return passed;
-}
-
-async function main () {
-  console.log('🧪 SSE tests for template MCP server');
-  console.log('='.repeat(60));
-
-  // Get authentication headers based on config
-  const headers = getAuthHeadersForTests();
-  if (Object.keys(headers).length) {
-    console.log('  Authentication enabled');
-  } else if (appConfig.webServer?.auth?.enabled) {
-    console.log('⚠️  Warning: Auth is enabled but no valid credentials found');
-  }
-
-  const client = new McpSseClient(baseUrl, headers);
-  try {
-    // Health check (optional)
-    await client.health().catch(() => undefined);
-
-    // Initialize over RPC channel used by SSE client (POST /rpc)
-    await client.sendRequest('initialize', {
-      protocolVersion: '2024-11-05',
-      capabilities: { tools: {} },
-      clientInfo: { name: 'sse-test', version: '1.0.0' },
-    }).catch(() => undefined);
-
-    const p1 = await runTestGroup('Prompts', TEMPLATE_TESTS.prompts, client);
-    const p2 = await runTestGroup('Resources', TEMPLATE_TESTS.resources, client);
-    const p3 = await runTestGroup('Tools', TEMPLATE_TESTS.tools, client);
-
-    const total = TEMPLATE_TESTS.prompts.length + TEMPLATE_TESTS.resources.length + TEMPLATE_TESTS.tools.length;
-    const sum = p1 + p2 + p3;
-    console.log(`\nSummary: ${sum}/${total} tests passed`);
-  } finally {
-    await client.close().catch(() => undefined);
-  }
-}
-
-main()
-  .then(() => {
-    process.exit(0);
-  })
-  .catch((e) => {
-    console.error('Test failed:', e?.message || e);
-    process.exit(1);
-  });
+#!/usr/bin/env node
+
+/**
+ * SSE transport tests for the template MCP server (src/template)
+ * Uses McpSseClient to send requests via HTTP and receive responses via SSE
+ */
+
+import { appConfig, McpSseClient, getAuthHeadersForTests } from '../../../dist/core/index.js';
+
+import TEMPLATE_TESTS from './test-cases.js';
+
+const baseUrl = (process.env.TEST_MCP_SERVER_URL || `http://localhost:${appConfig.webServer.port}`).replace(/\/+$/, '');
+
+async function runTestGroup (title, tests, client) {
+  console.log(`\n${title}:`);
+  let passed = 0;
+  for (const test of tests) {
+    try {
+      const res = await test(client);
+      if (res.passed) {
+        console.log(`  ✅  ${res.name}`);
+        passed++;
+      } else {
+        console.log(`  ❌  ${res.name}`);
+        if (res.details) {
+          console.log('     ', res.details);
+        }
+      }
+    } catch (e) {
+      console.log(`  ❌  ${test.name || 'test'}:`, e.message);
+    }
+  }
+  console.log(`  Result: ${passed}/${tests.length} passed`);
+  return passed;
+}
+
+async function main () {
+  console.log('🧪 SSE tests for template MCP server');
+  console.log('='.repeat(60));
+
+  // Get authentication headers based on config
+  const headers = getAuthHeadersForTests();
+  if (Object.keys(headers).length) {
+    console.log('  Authentication enabled');
+  } else if (appConfig.webServer?.auth?.enabled) {
+    console.log('⚠️  Warning: Auth is enabled but no valid credentials found');
+  }
+
+  const client = new McpSseClient(baseUrl, headers);
+  try {
+    // Health check (optional)
+    await client.health().catch(() => undefined);
+
+    // Initialize over RPC channel used by SSE client (POST /rpc)
+    await client.sendRequest('initialize', {
+      protocolVersion: '2024-11-05',
+      capabilities: { tools: {} },
+      clientInfo: { name: 'sse-test', version: '1.0.0' },
+    }).catch(() => undefined);
+
+    const p1 = await runTestGroup('Prompts', TEMPLATE_TESTS.prompts, client);
+    const p2 = await runTestGroup('Resources', TEMPLATE_TESTS.resources, client);
+    const p3 = await runTestGroup('Tools', TEMPLATE_TESTS.tools, client);
+
+    const total = TEMPLATE_TESTS.prompts.length + TEMPLATE_TESTS.resources.length + TEMPLATE_TESTS.tools.length;
+    const sum = p1 + p2 + p3;
+    console.log(`\nSummary: ${sum}/${total} tests passed`);
+  } finally {
+    await client.close().catch(() => undefined);
+  }
+}
+
+main()
+  .then(() => {
+    process.exit(0);
+  })
+  .catch((e) => {
+    console.error('Test failed:', e?.message || e);
+    process.exit(1);
+  });