@modelcontextprotocol/server-everything 0.6.2 → 2025.3.19

package/README.md

@@ -1,4 +1,4 @@
-# Everything MCP Server 
+# Everything MCP Server
 
 This MCP server attempts to exercise all the features of the MCP protocol. It is not intended to be a useful server, but rather a test server for builders of MCP clients. It implements prompts, tools, resources, sampling, and more to showcase MCP capabilities.
 
@@ -15,7 +15,7 @@ This MCP server attempts to exercise all the features of the MCP protocol. It is
 2. `add`
    - Adds two numbers together
    - Inputs:
-     - `a` (number): First number 
+     - `a` (number): First number
      - `b` (number): Second number
    - Returns: Text result of the addition
 
@@ -27,7 +27,7 @@ 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. `sampleLLM`
    - Demonstrates LLM sampling capability using MCP sampling feature
    - Inputs:
      - `prompt` (string): The prompt to send to the LLM
@@ -39,17 +39,41 @@ This MCP server attempts to exercise all the features of the MCP protocol. It is
    - 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:
+     - `messageType` (enum: "error" | "success" | "debug"): Type of message to demonstrate different annotation patterns
+     - `includeImage` (boolean, default: false): Whether to include an example image
+   - Returns: Content with varying annotations:
+     - Error messages: High priority (1.0), visible to both user and assistant
+     - Success messages: Medium priority (0.7), user-focused
+     - Debug messages: Low priority (0.3), assistant-focused
+     - Optional image: Medium priority (0.5), user-focused
+   - Example annotations:
+     ```json
+     {
+       "priority": 1.0,
+       "audience": ["user", "assistant"]
+     }
+     ```
+
 ### Resources
 
 The server provides 100 test resources in two formats:
-- Even numbered resources: 
+- Even numbered resources:
   - Plaintext format
   - URI pattern: `test://static/resource/{even_number}`
   - Content: Simple text description
 
 - Odd numbered resources:
   - Binary blob format
-  - URI pattern: `test://static/resource/{odd_number}`  
+  - URI pattern: `test://static/resource/{odd_number}`
   - Content: Base64 encoded binary data
 
 Resource features:
@@ -72,6 +96,20 @@ Resource features:
      - `style` (string): Output style preference
    - Returns: Multi-turn conversation with images
 
+### Logging
+
+The server sends random-leveled log messages every 15 seconds, e.g.:
+
+```json
+{
+  "method": "notifications/message",
+  "params": {
+	"level": "info",
+	"data": "Info-level message"
+  }
+}
+```
+
 ## Usage with Claude Desktop
 
 Add to your `claude_desktop_config.json`:

package/dist/everything.js

@@ -1,5 +1,5 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { CallToolRequestSchema, CreateMessageResultSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, SetLevelRequestSchema, SubscribeRequestSchema, ToolSchema, UnsubscribeRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema, CompleteRequestSchema, CreateMessageResultSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, SetLevelRequestSchema, SubscribeRequestSchema, ToolSchema, UnsubscribeRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { z } from "zod";
 import { zodToJsonSchema } from "zod-to-json-schema";
 const ToolInputSchema = ToolSchema.shape.inputSchema;
@@ -18,6 +18,7 @@ const LongRunningOperationSchema = z.object({
         .describe("Duration of the operation in seconds"),
     steps: z.number().default(5).describe("Number of steps in the operation"),
 });
+const PrintEnvSchema = z.object({});
 const SampleLLMSchema = z.object({
     prompt: z.string().describe("The prompt to send to the LLM"),
     maxTokens: z
@@ -25,14 +26,28 @@ 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.enum(["error", "success", "debug"])
+        .describe("Type of message to demonstrate different annotation patterns"),
+    includeImage: z.boolean().default(false)
+        .describe("Whether to include an example image")
+});
 var ToolName;
 (function (ToolName) {
     ToolName["ECHO"] = "echo";
     ToolName["ADD"] = "add";
     ToolName["LONG_RUNNING_OPERATION"] = "longRunningOperation";
+    ToolName["PRINT_ENV"] = "printEnv";
     ToolName["SAMPLE_LLM"] = "sampleLLM";
     ToolName["GET_TINY_IMAGE"] = "getTinyImage";
+    ToolName["ANNOTATED_MESSAGE"] = "annotatedMessage";
 })(ToolName || (ToolName = {}));
 var PromptName;
 (function (PromptName) {
@@ -52,9 +67,9 @@ export const createServer = () => {
         },
     });
     let subscriptions = new Set();
-    let updateInterval;
+    let subsUpdateInterval;
     // Set up update interval for subscribed resources
-    updateInterval = setInterval(() => {
+    subsUpdateInterval = setInterval(() => {
         for (const uri of subscriptions) {
             server.notification({
                 method: "notifications/resources/updated",
@@ -62,6 +77,32 @@ export const createServer = () => {
             });
         }
     }, 5000);
+    let logLevel = "debug";
+    let logsUpdateInterval;
+    const messages = [
+        { level: "debug", data: "Debug-level message" },
+        { level: "info", data: "Info-level message" },
+        { level: "notice", data: "Notice-level message" },
+        { level: "warning", data: "Warning-level message" },
+        { level: "error", data: "Error-level message" },
+        { level: "critical", data: "Critical-level message" },
+        { level: "alert", data: "Alert level-message" },
+        { level: "emergency", data: "Emergency-level message" }
+    ];
+    const isMessageIgnored = (level) => {
+        const currentLevel = messages.findIndex((msg) => logLevel === msg.level);
+        const messageLevel = messages.findIndex((msg) => level === msg.level);
+        return messageLevel < currentLevel;
+    };
+    // Set up update interval for random log messages
+    logsUpdateInterval = setInterval(() => {
+        let message = {
+            method: "notifications/message",
+            params: messages[Math.floor(Math.random() * messages.length)],
+        };
+        if (!isMessageIgnored(message.params.level))
+            server.notification(message);
+    }, 15000);
     // Helper method to request sampling from client
     const requestSampling = async (context, uri, maxTokens = 100) => {
         const request = {
@@ -243,6 +284,11 @@ 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",
@@ -258,6 +304,11 @@ export const createServer = () => {
                 description: "Returns the MCP_TINY_IMAGE",
                 inputSchema: zodToJsonSchema(GetTinyImageSchema),
             },
+            {
+                name: ToolName.ANNOTATED_MESSAGE,
+                description: "Demonstrates how annotations can be used to provide metadata about content",
+                inputSchema: zodToJsonSchema(AnnotatedMessageSchema),
+            },
         ];
         return { tools };
     });
@@ -308,12 +359,22 @@ export const createServer = () => {
                 ],
             };
         }
+        if (name === ToolName.PRINT_ENV) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(process.env, null, 2),
+                    },
+                ],
+            };
+        }
         if (name === ToolName.SAMPLE_LLM) {
             const validatedArgs = SampleLLMSchema.parse(args);
             const { prompt, maxTokens } = validatedArgs;
             const result = await requestSampling(prompt, ToolName.SAMPLE_LLM, maxTokens);
             return {
-                content: [{ type: "text", text: `LLM sampling result: ${result}` }],
+                content: [{ type: "text", text: `LLM sampling result: ${result.content.text}` }],
             };
         }
         if (name === ToolName.GET_TINY_IMAGE) {
@@ -336,25 +397,95 @@ export const createServer = () => {
                 ],
             };
         }
+        if (name === ToolName.ANNOTATED_MESSAGE) {
+            const { messageType, includeImage } = AnnotatedMessageSchema.parse(args);
+            const content = [];
+            // Main message with different priorities/audiences based on type
+            if (messageType === "error") {
+                content.push({
+                    type: "text",
+                    text: "Error: Operation failed",
+                    annotations: {
+                        priority: 1.0, // Errors are highest priority
+                        audience: ["user", "assistant"] // Both need to know about errors
+                    }
+                });
+            }
+            else if (messageType === "success") {
+                content.push({
+                    type: "text",
+                    text: "Operation completed successfully",
+                    annotations: {
+                        priority: 0.7, // Success messages are important but not critical
+                        audience: ["user"] // Success mainly for user consumption
+                    }
+                });
+            }
+            else if (messageType === "debug") {
+                content.push({
+                    type: "text",
+                    text: "Debug: Cache hit ratio 0.95, latency 150ms",
+                    annotations: {
+                        priority: 0.3, // Debug info is low priority
+                        audience: ["assistant"] // Technical details for assistant
+                    }
+                });
+            }
+            // Optional image with its own annotations
+            if (includeImage) {
+                content.push({
+                    type: "image",
+                    data: MCP_TINY_IMAGE,
+                    mimeType: "image/png",
+                    annotations: {
+                        priority: 0.5,
+                        audience: ["user"] // Images primarily for user visualization
+                    }
+                });
+            }
+            return { content };
+        }
         throw new Error(`Unknown tool: ${name}`);
     });
+    server.setRequestHandler(CompleteRequestSchema, async (request) => {
+        const { ref, argument } = request.params;
+        if (ref.type === "ref/resource") {
+            const resourceId = ref.uri.split("/").pop();
+            if (!resourceId)
+                return { completion: { values: [] } };
+            // Filter resource IDs that start with the input value
+            const values = EXAMPLE_COMPLETIONS.resourceId.filter(id => id.startsWith(argument.value));
+            return { completion: { values, hasMore: false, total: values.length } };
+        }
+        if (ref.type === "ref/prompt") {
+            // Handle completion for prompt arguments
+            const completions = EXAMPLE_COMPLETIONS[argument.name];
+            if (!completions)
+                return { completion: { values: [] } };
+            const values = completions.filter(value => value.startsWith(argument.value));
+            return { completion: { values, hasMore: false, total: values.length } };
+        }
+        throw new Error(`Unknown reference type`);
+    });
     server.setRequestHandler(SetLevelRequestSchema, async (request) => {
         const { level } = request.params;
+        logLevel = level;
         // Demonstrate different log levels
         await server.notification({
             method: "notifications/message",
             params: {
                 level: "debug",
                 logger: "test-server",
-                data: `Logging level set to: ${level}`,
+                data: `Logging level set to: ${logLevel}`,
             },
         });
         return {};
     });
     const cleanup = async () => {
-        if (updateInterval) {
-            clearInterval(updateInterval);
-        }
+        if (subsUpdateInterval)
+            clearInterval(subsUpdateInterval);
+        if (logsUpdateInterval)
+            clearInterval(logsUpdateInterval);
     };
     return { server, cleanup };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelcontextprotocol/server-everything",
-  "version": "0.6.2",
+  "version": "2025.3.19",
   "description": "MCP server that exercises all the features of the MCP protocol",
   "license": "MIT",
   "author": "Anthropic, PBC (https://anthropic.com)",
@@ -16,7 +16,9 @@
   "scripts": {
     "build": "tsc && shx chmod +x dist/*.js",
     "prepare": "npm run build",
-    "watch": "tsc --watch"
+    "watch": "tsc --watch",
+    "start": "node dist/index.js",
+    "start:sse": "node dist/sse.js"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.0.1",