fa-mcp-sdk 0.4.142 → 0.11.2

package/src/template/tools/tools.ts

@@ -5,64 +5,125 @@ import { IToolInputSchema, IToolProperties } from '../../core/index.js';
 /**
  * Template tools configuration for MCP Server
  * Define your tools according to your server's functionality
+ *
+ * Schemas follow JSON Schema draft 2020-12 (`$schema`) and reject unknown fields
+ * (`additionalProperties: false`) — required by standard §9.2.
  */
 
-const getGenericInputSchema = (queryDescription?: string, additionalProperties?: IToolProperties): IToolInputSchema => {
-  const properties = {
+const JSON_SCHEMA_2020_12 = 'https://json-schema.org/draft/2020-12/schema';
+
+const getGenericInputSchema = (
+  queryDescription?: string,
+  additionalProperties?: IToolProperties,
+): IToolInputSchema => ({
+  $schema: JSON_SCHEMA_2020_12,
+  type: 'object',
+  properties: {
     query: {
       type: 'string',
       description: queryDescription || 'Input query or text',
     },
     ...additionalProperties,
-  };
+  },
+  required: ['query'],
+  additionalProperties: false,
+});
 
-  return {
-    type: 'object',
-    properties,
-    required: ['query'],
-  };
-};
+const getSearchInputSchema = (): IToolInputSchema => ({
+  $schema: JSON_SCHEMA_2020_12,
+  type: 'object',
+  properties: {
+    query: {
+      type: 'string',
+      description: 'Search query',
+    },
+    limit: {
+      type: 'number',
+      description: 'Maximum number of results to return (1-100, default: 20)',
+      minimum: 1,
+      maximum: 100,
+    },
+    threshold: {
+      type: 'number',
+      description: 'Minimum similarity threshold (0-1)',
+      minimum: 0,
+      maximum: 1,
+    },
+  },
+  required: ['query'],
+  additionalProperties: false,
+});
 
-const getSearchInputSchema = (): IToolInputSchema => {
-  return {
-    type: 'object',
-    properties: {
-      query: {
-        type: 'string',
-        description: 'Search query',
-      },
-      limit: {
-        type: 'number',
-        description: 'Maximum number of results to return (1-100, default: 20)',
-        minimum: 1,
-        maximum: 100,
-      },
-      threshold: {
-        type: 'number',
-        description: 'Minimum similarity threshold (0-1)',
-        minimum: 0,
-        maximum: 1,
+const exampleSearchOutputSchema = {
+  $schema: JSON_SCHEMA_2020_12,
+  type: 'object',
+  properties: {
+    results: {
+      type: 'array',
+      items: {
+        type: 'object',
+        properties: {
+          id: { type: 'string' },
+          score: { type: 'number' },
+          text: { type: 'string' },
+        },
+        required: ['id'],
+        additionalProperties: true,
       },
     },
-    required: ['query'],
-  };
-};
+    total: { type: 'number' },
+  },
+  required: ['results'],
+  additionalProperties: true,
+} as const;
 
 // Template tools - customize according to your needs
 export const tools: Tool[] = [
   {
     name: 'example_tool',
+    title: 'Example: process text',
     description: 'Example tool that processes text input. Replace with your actual tools.',
     inputSchema: getGenericInputSchema('Text to process'),
   },
   {
     name: 'example_search',
+    title: 'Example: search with filters',
     description: 'Example search tool with pagination and filtering. Template for search-based tools.',
     inputSchema: getSearchInputSchema(),
+    outputSchema: exampleSearchOutputSchema as any,
   },
+  {
+    // Standard §8.7 / §9.1 — example of a long-running tool that opts in to task-augmented
+    // execution. With `mcp.tasks.enabled: true`, a client MAY send a `task` param to tools/call:
+    // the server returns a taskId immediately, runs this handler in the background (reporting
+    // progress and honouring cancellation), and the client polls tasks/get + tasks/result.
+    // `taskSupport: 'optional'` keeps the tool callable synchronously too — choose a task when the
+    // work can exceed the 30s tool timeout or you want a cancellable, pollable operation.
+    name: 'example_long_task',
+    title: 'Example: long-running task',
+    description:
+      'Example long-running tool that emits progress and supports cancellation. ' +
+      'Demonstrates task-augmented execution (§8.7) — call it with a `task` param to run it as a task.',
+    inputSchema: {
+      $schema: JSON_SCHEMA_2020_12,
+      type: 'object',
+      properties: {
+        steps: {
+          type: 'number',
+          description: 'Number of processing steps to simulate (1-20, default 5)',
+          minimum: 1,
+          maximum: 20,
+        },
+      },
+      required: [],
+      additionalProperties: false,
+    },
+    execution: { taskSupport: 'optional' },
+  } as Tool,
   // TODO: Add your actual tools here
   // {
   //   name: 'your_tool_name',
+  //   title: 'Human-readable title shown in UI',
   //   description: 'Description of what your tool does',
   //   inputSchema: getGenericInputSchema('Your query description', {
   //     // additional parameters

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

@@ -39,7 +39,7 @@ async function main() {
   console.log('='.repeat(60));
 
   // Get authentication headers based on config
-  const headers = getAuthHeadersForTests();
+  const headers = await getAuthHeadersForTests();
   if (Object.keys(headers).length) {
     console.log('  Authentication enabled');
   } else if (appConfig.webServer?.auth?.enabled) {

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

@@ -39,7 +39,7 @@ async function main() {
   console.log('='.repeat(60));
 
   // Get authentication headers based on config
-  const headers = getAuthHeadersForTests();
+  const headers = await getAuthHeadersForTests();
   if (Object.keys(headers).length) {
     console.log('  Authentication enabled');
   } else if (appConfig.webServer?.auth?.enabled) {