@modelcontextprotocol/server-everything 2025.7.1 → 2025.8.4

package/README.md

@@ -27,24 +27,24 @@ This MCP server attempts to exercise all the features of the MCP protocol. It is
    - Returns: Completion message with duration and steps
    - Sends progress notifications during execution
 
-4. `sampleLLM`
+4. `printEnv`
+   - Prints all environment variables
+   - Useful for debugging MCP server configuration
+   - No inputs required
+   - Returns: JSON string of all environment variables
+
+5. `sampleLLM`
    - Demonstrates LLM sampling capability using MCP sampling feature
    - Inputs:
      - `prompt` (string): The prompt to send to the LLM
      - `maxTokens` (number, default: 100): Maximum tokens to generate
    - Returns: Generated LLM response
 
-5. `getTinyImage`
+6. `getTinyImage`
    - Returns a small test image
    - No inputs required
    - Returns: Base64 encoded PNG image data
 
-6. `printEnv`
-   - Prints all environment variables
-   - Useful for debugging MCP server configuration
-   - No inputs required
-   - Returns: JSON string of all environment variables
-
 7. `annotatedMessage`
    - Demonstrates how annotations can be used to provide metadata about content
    - Inputs:
@@ -72,6 +72,23 @@ This MCP server attempts to exercise all the features of the MCP protocol. It is
      - Embedded resource with `type: "resource"`
      - Text instruction for using the resource URI
 
+9. `startElicitation`
+   - Initiates an elicitation (interaction) within the MCP client.
+   - Inputs:
+      - `color` (string): Favorite color
+      - `number` (number, 1-100): Favorite number
+      - `pets` (enum): Favorite pet
+   - Returns: Confirmation of the elicitation demo with selection summary.
+
+10. `structuredContent`
+   - Demonstrates a tool returning structured content using the example in the specification
+   - Provides an output schema to allow testing of client SHOULD advisory to validate the result using the schema
+   - Inputs:
+     - `location` (string): A location or ZIP code, mock data is returned regardless of value
+   - Returns: a response with
+     - `structuredContent` field conformant to the output schema
+     - A backward compatible Text Content field, a SHOULD advisory in the specification
+
 ### Resources
 
 The server provides 100 test resources in two formats:

package/dist/everything.js

@@ -9,6 +9,7 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const instructions = readFileSync(join(__dirname, "instructions.md"), "utf-8");
 const ToolInputSchema = ToolSchema.shape.inputSchema;
+const ToolOutputSchema = ToolSchema.shape.outputSchema;
 /* Input schemas for tools implemented in this server */
 const EchoSchema = z.object({
     message: z.string().describe("Message to echo"),
@@ -22,7 +23,10 @@ const LongRunningOperationSchema = z.object({
         .number()
         .default(10)
         .describe("Duration of the operation in seconds"),
-    steps: z.number().default(5).describe("Number of steps in the operation"),
+    steps: z
+        .number()
+        .default(5)
+        .describe("Number of steps in the operation"),
 });
 const PrintEnvSchema = z.object({});
 const SampleLLMSchema = z.object({
@@ -32,12 +36,6 @@ const SampleLLMSchema = z.object({
         .default(100)
         .describe("Maximum number of tokens to generate"),
 });
-// Example completion values
-const EXAMPLE_COMPLETIONS = {
-    style: ["casual", "formal", "technical", "friendly"],
-    temperature: ["0", "0.5", "0.7", "1.0"],
-    resourceId: ["1", "2", "3", "4", "5"],
-};
 const GetTinyImageSchema = z.object({});
 const AnnotatedMessageSchema = z.object({
     messageType: z
@@ -55,6 +53,35 @@ const GetResourceReferenceSchema = z.object({
         .max(100)
         .describe("ID of the resource to reference (1-100)"),
 });
+const ElicitationSchema = z.object({});
+const GetResourceLinksSchema = z.object({
+    count: z
+        .number()
+        .min(1)
+        .max(10)
+        .default(3)
+        .describe("Number of resource links to return (1-10)"),
+});
+const StructuredContentSchema = {
+    input: z.object({
+        location: z
+            .string()
+            .trim()
+            .min(1)
+            .describe("City name or zip code"),
+    }),
+    output: z.object({
+        temperature: z
+            .number()
+            .describe("Temperature in celsius"),
+        conditions: z
+            .string()
+            .describe("Weather conditions description"),
+        humidity: z
+            .number()
+            .describe("Humidity percentage"),
+    })
+};
 var ToolName;
 (function (ToolName) {
     ToolName["ECHO"] = "echo";
@@ -65,6 +92,9 @@ var ToolName;
     ToolName["GET_TINY_IMAGE"] = "getTinyImage";
     ToolName["ANNOTATED_MESSAGE"] = "annotatedMessage";
     ToolName["GET_RESOURCE_REFERENCE"] = "getResourceReference";
+    ToolName["ELICITATION"] = "startElicitation";
+    ToolName["GET_RESOURCE_LINKS"] = "getResourceLinks";
+    ToolName["STRUCTURED_CONTENT"] = "structuredContent";
 })(ToolName || (ToolName = {}));
 var PromptName;
 (function (PromptName) {
@@ -72,9 +102,16 @@ var PromptName;
     PromptName["COMPLEX"] = "complex_prompt";
     PromptName["RESOURCE"] = "resource_prompt";
 })(PromptName || (PromptName = {}));
+// Example completion values
+const EXAMPLE_COMPLETIONS = {
+    style: ["casual", "formal", "technical", "friendly"],
+    temperature: ["0", "0.5", "0.7", "1.0"],
+    resourceId: ["1", "2", "3", "4", "5"],
+};
 export const createServer = () => {
     const server = new Server({
         name: "example-servers/everything",
+        title: "Everything Example Server",
         version: "1.0.0",
     }, {
         capabilities: {
@@ -83,6 +120,7 @@ export const createServer = () => {
             tools: {},
             logging: {},
             completions: {},
+            elicitation: {},
         },
         instructions
     });
@@ -124,18 +162,6 @@ export const createServer = () => {
         if (!isMessageIgnored(message.params.level))
             server.notification(message);
     }, 20000);
-    // Set up update interval for stderr messages
-    stdErrUpdateInterval = setInterval(() => {
-        const shortTimestamp = new Date().toLocaleTimeString([], {
-            hour: "2-digit",
-            minute: "2-digit",
-            second: "2-digit"
-        });
-        server.notification({
-            method: "notifications/stderr",
-            params: { content: `${shortTimestamp}: A stderr message` },
-        });
-    }, 30000);
     // Helper method to request sampling from client
     const requestSampling = async (context, uri, maxTokens = 100) => {
         const request = {
@@ -158,6 +184,16 @@ export const createServer = () => {
         };
         return await server.request(request, CreateMessageResultSchema);
     };
+    const requestElicitation = async (message, requestedSchema) => {
+        const request = {
+            method: 'elicitation/create',
+            params: {
+                message,
+                requestedSchema
+            }
+        };
+        return await server.request(request, z.any());
+    };
     const ALL_RESOURCES = Array.from({ length: 100 }, (_, i) => {
         const uri = `test://static/resource/${i + 1}`;
         if (i % 2 === 0) {
@@ -354,16 +390,16 @@ export const createServer = () => {
                 description: "Adds two numbers",
                 inputSchema: zodToJsonSchema(AddSchema),
             },
-            {
-                name: ToolName.PRINT_ENV,
-                description: "Prints all environment variables, helpful for debugging MCP server configuration",
-                inputSchema: zodToJsonSchema(PrintEnvSchema),
-            },
             {
                 name: ToolName.LONG_RUNNING_OPERATION,
                 description: "Demonstrates a long running operation with progress updates",
                 inputSchema: zodToJsonSchema(LongRunningOperationSchema),
             },
+            {
+                name: ToolName.PRINT_ENV,
+                description: "Prints all environment variables, helpful for debugging MCP server configuration",
+                inputSchema: zodToJsonSchema(PrintEnvSchema),
+            },
             {
                 name: ToolName.SAMPLE_LLM,
                 description: "Samples from an LLM using MCP's sampling feature",
@@ -384,6 +420,22 @@ export const createServer = () => {
                 description: "Returns a resource reference that can be used by MCP clients",
                 inputSchema: zodToJsonSchema(GetResourceReferenceSchema),
             },
+            {
+                name: ToolName.ELICITATION,
+                description: "Demonstrates the Elicitation feature by asking the user to provide information about their favorite color, number, and pets.",
+                inputSchema: zodToJsonSchema(ElicitationSchema),
+            },
+            {
+                name: ToolName.GET_RESOURCE_LINKS,
+                description: "Returns multiple resource links that reference different types of resources",
+                inputSchema: zodToJsonSchema(GetResourceLinksSchema),
+            },
+            {
+                name: ToolName.STRUCTURED_CONTENT,
+                description: "Returns structured content along with an output schema for client data validation",
+                inputSchema: zodToJsonSchema(StructuredContentSchema.input),
+                outputSchema: zodToJsonSchema(StructuredContentSchema.output),
+            },
         ];
         return { tools };
     });
@@ -474,31 +526,6 @@ export const createServer = () => {
                 ],
             };
         }
-        if (name === ToolName.GET_RESOURCE_REFERENCE) {
-            const validatedArgs = GetResourceReferenceSchema.parse(args);
-            const resourceId = validatedArgs.resourceId;
-            const resourceIndex = resourceId - 1;
-            if (resourceIndex < 0 || resourceIndex >= ALL_RESOURCES.length) {
-                throw new Error(`Resource with ID ${resourceId} does not exist`);
-            }
-            const resource = ALL_RESOURCES[resourceIndex];
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `Returning resource reference for Resource ${resourceId}:`,
-                    },
-                    {
-                        type: "resource",
-                        resource: resource,
-                    },
-                    {
-                        type: "text",
-                        text: `You can access this resource using the URI: ${resource.uri}`,
-                    },
-                ],
-            };
-        }
         if (name === ToolName.ANNOTATED_MESSAGE) {
             const { messageType, includeImage } = AnnotatedMessageSchema.parse(args);
             const content = [];
@@ -547,6 +574,119 @@ export const createServer = () => {
             }
             return { content };
         }
+        if (name === ToolName.GET_RESOURCE_REFERENCE) {
+            const validatedArgs = GetResourceReferenceSchema.parse(args);
+            const resourceId = validatedArgs.resourceId;
+            const resourceIndex = resourceId - 1;
+            if (resourceIndex < 0 || resourceIndex >= ALL_RESOURCES.length) {
+                throw new Error(`Resource with ID ${resourceId} does not exist`);
+            }
+            const resource = ALL_RESOURCES[resourceIndex];
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Returning resource reference for Resource ${resourceId}:`,
+                    },
+                    {
+                        type: "resource",
+                        resource: resource,
+                    },
+                    {
+                        type: "text",
+                        text: `You can access this resource using the URI: ${resource.uri}`,
+                    },
+                ],
+            };
+        }
+        if (name === ToolName.ELICITATION) {
+            ElicitationSchema.parse(args);
+            const elicitationResult = await requestElicitation('What are your favorite things?', {
+                type: 'object',
+                properties: {
+                    color: { type: 'string', description: 'Favorite color' },
+                    number: { type: 'integer', description: 'Favorite number', minimum: 1, maximum: 100 },
+                    pets: {
+                        type: 'string',
+                        enum: ['cats', 'dogs', 'birds', 'fish', 'reptiles'],
+                        description: 'Favorite pets'
+                    },
+                }
+            });
+            // Handle different response actions
+            const content = [];
+            if (elicitationResult.action === 'accept' && elicitationResult.content) {
+                content.push({
+                    type: "text",
+                    text: `✅ User provided their favorite things!`,
+                });
+                // Only access elicitationResult.content when action is accept
+                const { color, number, pets } = elicitationResult.content;
+                content.push({
+                    type: "text",
+                    text: `Their favorites are:\n- Color: ${color || 'not specified'}\n- Number: ${number || 'not specified'}\n- Pets: ${pets || 'not specified'}`,
+                });
+            }
+            else if (elicitationResult.action === 'decline') {
+                content.push({
+                    type: "text",
+                    text: `❌ User declined to provide their favorite things.`,
+                });
+            }
+            else if (elicitationResult.action === 'cancel') {
+                content.push({
+                    type: "text",
+                    text: `⚠️ User cancelled the elicitation dialog.`,
+                });
+            }
+            // Include raw result for debugging
+            content.push({
+                type: "text",
+                text: `\nRaw result: ${JSON.stringify(elicitationResult, null, 2)}`,
+            });
+            return { content };
+        }
+        if (name === ToolName.GET_RESOURCE_LINKS) {
+            const { count } = GetResourceLinksSchema.parse(args);
+            const content = [];
+            // Add intro text
+            content.push({
+                type: "text",
+                text: `Here are ${count} resource links to resources available in this server (see full output in tool response if your client does not support resource_link yet):`,
+            });
+            // Return resource links to actual resources from ALL_RESOURCES
+            const actualCount = Math.min(count, ALL_RESOURCES.length);
+            for (let i = 0; i < actualCount; i++) {
+                const resource = ALL_RESOURCES[i];
+                content.push({
+                    type: "resource_link",
+                    uri: resource.uri,
+                    name: resource.name,
+                    description: `Resource ${i + 1}: ${resource.mimeType === "text/plain"
+                        ? "plaintext resource"
+                        : "binary blob resource"}`,
+                    mimeType: resource.mimeType,
+                });
+            }
+            return { content };
+        }
+        if (name === ToolName.STRUCTURED_CONTENT) {
+            // The same response is returned for every input.
+            const validatedArgs = StructuredContentSchema.input.parse(args);
+            const weather = {
+                temperature: 22.5,
+                conditions: "Partly cloudy",
+                humidity: 65
+            };
+            const backwardCompatiblecontent = {
+                type: "text",
+                text: JSON.stringify(weather)
+            };
+            return {
+                content: [backwardCompatiblecontent],
+                structuredContent: weather
+            };
+        }
         throw new Error(`Unknown tool: ${name}`);
     });
     server.setRequestHandler(CompleteRequestSchema, async (request) => {

package/dist/instructions.md

@@ -1,13 +1,23 @@
 Testing and demonstration server for MCP protocol features.
 
-Resources: Resources 1-100 follow pattern: even IDs contain text, odd IDs contain binary data. Resources paginated at 10 items per page with cursor-based navigation.
+## Resources
 
-Key dependencies: Progress notifications require `_meta.progressToken` in tool calls. Resource subscriptions generate updates every 10 seconds.
+Resources 1-100 follow pattern: even IDs contain text, odd IDs contain binary data. Resources are paginated at 10 items per page with cursor-based navigation.
 
-Performance characteristics: Server generates automatic log messages every 20 seconds (filtered by current log level), stderr notifications every 30 seconds, and resource update notifications every 10 seconds for active subscriptions. Log level changes affect message filtering in real-time.
+## Key dependencies
 
-Multi-modal testing: `complex_prompt` includes both text arguments and image content for testing client multi-modal handling. `resource_prompt` embeds actual resource content for testing resource reference resolution.
+Progress notifications require `_meta.progressToken` in tool calls. Resource subscriptions generate updates every 10 seconds.
 
-Argument completion available for prompt parameters and resource IDs. Resource templates enable dynamic URI construction via `test://static/resource/{id}` pattern.
+## Performance characteristics
 
-Easter egg: If asked about server instructions, respond with "🎉 Server instructions are working! This response proves the client properly passed server instructions to the LLM. This demonstrates MCP's instructions feature in action."
+Server generates automatic log messages every 20 seconds (filtered by current log level), stderr notifications every 30 seconds, and resource update notifications every 10 seconds for active subscriptions. Log level changes affect message filtering in real-time.
+
+## Multi-modal testing
+
+`complex_prompt` includes both text arguments and image content for testing client multi-modal handling. `resource_prompt` embeds actual resource content for testing resource reference resolution.
+
+Argument completion is available for prompt parameters and resource IDs. Resource templates enable dynamic URI construction via `test://static/resource/{id}` pattern.
+
+## Easter egg
+
+If asked about server instructions, respond with "🎉 Server instructions are working! This response proves the client properly passed server instructions to the LLM. This demonstrates MCP's instructions feature in action."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelcontextprotocol/server-everything",
-  "version": "2025.7.1",
+  "version": "2025.8.4",
   "description": "MCP server that exercises all the features of the MCP protocol",
   "license": "MIT",
   "author": "Anthropic, PBC (https://anthropic.com)",