@modelcontextprotocol/server-everything 2025.1.14 → 2025.3.19

package/README.md

@@ -45,6 +45,24 @@ This MCP server attempts to exercise all the features of the MCP protocol. It is
    - 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:
@@ -78,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

@@ -33,6 +33,12 @@ const EXAMPLE_COMPLETIONS = {
     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";
@@ -41,6 +47,7 @@ var ToolName;
     ToolName["PRINT_ENV"] = "printEnv";
     ToolName["SAMPLE_LLM"] = "sampleLLM";
     ToolName["GET_TINY_IMAGE"] = "getTinyImage";
+    ToolName["ANNOTATED_MESSAGE"] = "annotatedMessage";
 })(ToolName || (ToolName = {}));
 var PromptName;
 (function (PromptName) {
@@ -60,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",
@@ -70,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 = {
@@ -271,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 };
     });
@@ -359,6 +397,54 @@ 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) => {
@@ -383,21 +469,23 @@ export const createServer = () => {
     });
     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": "2025.1.14",
+  "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",