@modelcontextprotocol/server-everything 2025.3.19 → 2025.4.25

package/README.md

@@ -63,6 +63,15 @@ This MCP server attempts to exercise all the features of the MCP protocol. It is
      }
      ```
 
+8. `getResourceReference`
+   - Returns a resource reference that can be used by MCP clients
+   - Inputs:
+     - `resourceId` (number, 1-100): ID of the resource to reference
+   - Returns: A resource reference with:
+     - Text introduction
+     - Embedded resource with `type: "resource"`
+     - Text instruction for using the resource URI
+
 ### Resources
 
 The server provides 100 test resources in two formats:
@@ -96,6 +105,13 @@ Resource features:
      - `style` (string): Output style preference
    - Returns: Multi-turn conversation with images
 
+3. `resource_prompt`
+   - Demonstrates embedding resource references in prompts
+   - Required arguments:
+     - `resourceId` (number): ID of the resource to embed (1-100)
+   - Returns: Multi-turn conversation with an embedded resource reference
+   - Shows how to include resources directly in prompt messages
+
 ### Logging
 
 The server sends random-leveled log messages every 15 seconds, e.g.:
@@ -127,3 +143,32 @@ Add to your `claude_desktop_config.json`:
   }
 }
 ```
+
+## Usage with VS Code
+
+For quick installation, use of of the one-click install buttons below...
+
+[![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-NPM-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=everything&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-everything%22%5D%7D) [![Install with NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-NPM-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=everything&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-everything%22%5D%7D&quality=insiders)
+
+[![Install with Docker in VS Code](https://img.shields.io/badge/VS_Code-Docker-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=everything&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Feverything%22%5D%7D) [![Install with Docker in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Docker-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=everything&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Feverything%22%5D%7D&quality=insiders)
+
+For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing `Ctrl + Shift + P` and typing `Preferences: Open User Settings (JSON)`.
+
+Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others.
+
+> Note that the `mcp` key is not needed in the `.vscode/mcp.json` file.
+
+#### NPX
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "everything": {
+        "command": "npx",
+        "args": ["-y", "@modelcontextprotocol/server-everything"]
+      }
+    }
+  }
+}
+```

package/dist/everything.js

@@ -34,10 +34,20 @@ const EXAMPLE_COMPLETIONS = {
 };
 const GetTinyImageSchema = z.object({});
 const AnnotatedMessageSchema = z.object({
-    messageType: z.enum(["error", "success", "debug"])
+    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")
+    includeImage: z
+        .boolean()
+        .default(false)
+        .describe("Whether to include an example image"),
+});
+const GetResourceReferenceSchema = z.object({
+    resourceId: z
+        .number()
+        .min(1)
+        .max(100)
+        .describe("ID of the resource to reference (1-100)"),
 });
 var ToolName;
 (function (ToolName) {
@@ -48,11 +58,13 @@ var ToolName;
     ToolName["SAMPLE_LLM"] = "sampleLLM";
     ToolName["GET_TINY_IMAGE"] = "getTinyImage";
     ToolName["ANNOTATED_MESSAGE"] = "annotatedMessage";
+    ToolName["GET_RESOURCE_REFERENCE"] = "getResourceReference";
 })(ToolName || (ToolName = {}));
 var PromptName;
 (function (PromptName) {
     PromptName["SIMPLE"] = "simple_prompt";
     PromptName["COMPLEX"] = "complex_prompt";
+    PromptName["RESOURCE"] = "resource_prompt";
 })(PromptName || (PromptName = {}));
 export const createServer = () => {
     const server = new Server({
@@ -64,10 +76,12 @@ export const createServer = () => {
             resources: { subscribe: true },
             tools: {},
             logging: {},
+            completions: {},
         },
     });
     let subscriptions = new Set();
     let subsUpdateInterval;
+    let stdErrUpdateInterval;
     // Set up update interval for subscribed resources
     subsUpdateInterval = setInterval(() => {
         for (const uri of subscriptions) {
@@ -76,7 +90,7 @@ export const createServer = () => {
                 params: { uri },
             });
         }
-    }, 5000);
+    }, 10000);
     let logLevel = "debug";
     let logsUpdateInterval;
     const messages = [
@@ -87,7 +101,7 @@ export const createServer = () => {
         { level: "error", data: "Error-level message" },
         { level: "critical", data: "Critical-level message" },
         { level: "alert", data: "Alert level-message" },
-        { level: "emergency", data: "Emergency-level message" }
+        { level: "emergency", data: "Emergency-level message" },
     ];
     const isMessageIgnored = (level) => {
         const currentLevel = messages.findIndex((msg) => logLevel === msg.level);
@@ -102,7 +116,19 @@ export const createServer = () => {
         };
         if (!isMessageIgnored(message.params.level))
             server.notification(message);
-    }, 15000);
+    }, 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 = {
@@ -224,6 +250,17 @@ export const createServer = () => {
                         },
                     ],
                 },
+                {
+                    name: PromptName.RESOURCE,
+                    description: "A prompt that includes an embedded resource reference",
+                    arguments: [
+                        {
+                            name: "resourceId",
+                            description: "Resource ID to include (1-100)",
+                            required: true,
+                        },
+                    ],
+                },
             ],
         };
     });
@@ -270,6 +307,32 @@ export const createServer = () => {
                 ],
             };
         }
+        if (name === PromptName.RESOURCE) {
+            const resourceId = parseInt(args?.resourceId, 10);
+            if (isNaN(resourceId) || resourceId < 1 || resourceId > 100) {
+                throw new Error(`Invalid resourceId: ${args?.resourceId}. Must be a number between 1 and 100.`);
+            }
+            const resourceIndex = resourceId - 1;
+            const resource = ALL_RESOURCES[resourceIndex];
+            return {
+                messages: [
+                    {
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: `This prompt includes Resource ${resourceId}. Please analyze the following resource:`,
+                        },
+                    },
+                    {
+                        role: "user",
+                        content: {
+                            type: "resource",
+                            resource: resource,
+                        },
+                    },
+                ],
+            };
+        }
         throw new Error(`Unknown prompt: ${name}`);
     });
     server.setRequestHandler(ListToolsRequestSchema, async () => {
@@ -309,6 +372,11 @@ export const createServer = () => {
                 description: "Demonstrates how annotations can be used to provide metadata about content",
                 inputSchema: zodToJsonSchema(AnnotatedMessageSchema),
             },
+            {
+                name: ToolName.GET_RESOURCE_REFERENCE,
+                description: "Returns a resource reference that can be used by MCP clients",
+                inputSchema: zodToJsonSchema(GetResourceReferenceSchema),
+            },
         ];
         return { tools };
     });
@@ -374,7 +442,9 @@ export const createServer = () => {
             const { prompt, maxTokens } = validatedArgs;
             const result = await requestSampling(prompt, ToolName.SAMPLE_LLM, maxTokens);
             return {
-                content: [{ type: "text", text: `LLM sampling result: ${result.content.text}` }],
+                content: [
+                    { type: "text", text: `LLM sampling result: ${result.content.text}` },
+                ],
             };
         }
         if (name === ToolName.GET_TINY_IMAGE) {
@@ -397,6 +467,31 @@ 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 = [];
@@ -407,8 +502,8 @@ export const createServer = () => {
                     text: "Error: Operation failed",
                     annotations: {
                         priority: 1.0, // Errors are highest priority
-                        audience: ["user", "assistant"] // Both need to know about errors
-                    }
+                        audience: ["user", "assistant"], // Both need to know about errors
+                    },
                 });
             }
             else if (messageType === "success") {
@@ -417,8 +512,8 @@ export const createServer = () => {
                     text: "Operation completed successfully",
                     annotations: {
                         priority: 0.7, // Success messages are important but not critical
-                        audience: ["user"] // Success mainly for user consumption
-                    }
+                        audience: ["user"], // Success mainly for user consumption
+                    },
                 });
             }
             else if (messageType === "debug") {
@@ -427,8 +522,8 @@ export const createServer = () => {
                     text: "Debug: Cache hit ratio 0.95, latency 150ms",
                     annotations: {
                         priority: 0.3, // Debug info is low priority
-                        audience: ["assistant"] // Technical details for assistant
-                    }
+                        audience: ["assistant"], // Technical details for assistant
+                    },
                 });
             }
             // Optional image with its own annotations
@@ -439,8 +534,8 @@ export const createServer = () => {
                     mimeType: "image/png",
                     annotations: {
                         priority: 0.5,
-                        audience: ["user"] // Images primarily for user visualization
-                    }
+                        audience: ["user"], // Images primarily for user visualization
+                    },
                 });
             }
             return { content };
@@ -454,7 +549,7 @@ export const createServer = () => {
             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));
+            const values = EXAMPLE_COMPLETIONS.resourceId.filter((id) => id.startsWith(argument.value));
             return { completion: { values, hasMore: false, total: values.length } };
         }
         if (ref.type === "ref/prompt") {
@@ -462,7 +557,7 @@ export const createServer = () => {
             const completions = EXAMPLE_COMPLETIONS[argument.name];
             if (!completions)
                 return { completion: { values: [] } };
-            const values = completions.filter(value => value.startsWith(argument.value));
+            const values = completions.filter((value) => value.startsWith(argument.value));
             return { completion: { values, hasMore: false, total: values.length } };
         }
         throw new Error(`Unknown reference type`);
@@ -486,6 +581,8 @@ export const createServer = () => {
             clearInterval(subsUpdateInterval);
         if (logsUpdateInterval)
             clearInterval(logsUpdateInterval);
+        if (stdErrUpdateInterval)
+            clearInterval(stdErrUpdateInterval);
     };
     return { server, cleanup };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelcontextprotocol/server-everything",
-  "version": "2025.3.19",
+  "version": "2025.4.25",
   "description": "MCP server that exercises all the features of the MCP protocol",
   "license": "MIT",
   "author": "Anthropic, PBC (https://anthropic.com)",
@@ -21,7 +21,7 @@
     "start:sse": "node dist/sse.js"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "1.0.1",
+    "@modelcontextprotocol/sdk": "^1.9.0",
     "express": "^4.21.1",
     "zod": "^3.23.8",
     "zod-to-json-schema": "^3.23.5"