Everything MCP Server

A test server that demonstrates all features of the MCP protocol, including prompts, tools, resources, and sampling.

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.

- Simple tool to echo back input messages
- Input:

- message(string): Message to echo back

- Adds two numbers together
- Inputs:

- a(number): First number
- b(number): Second number

- Demonstrates progress notifications for long operations
- Inputs:

- duration(number, default: 10): Duration in seconds
- steps(number, default: 5): Number of progress steps

- 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 a small test image
- No inputs required
- Returns: Base64 encoded PNG image data

- Prints all environment variables
- Useful for debugging MCP server configuration
- No inputs required
- Returns: JSON string of all environment variables

- 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

- 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

{ "priority": 1.0, "audience": ["user", "assistant"] }

- Returns a resource reference that can be used by MCP clients
- Inputs:

- resourceId(number, 1-100): ID of the resource to reference

- Text introduction
- Embedded resource withtype: "resource"
- Text instruction for using the resource URI

The server provides 100 test resources in two formats:

- Plaintext format
- URI pattern:test://static/resource/{even_number}
- Content: Simple text description

- Binary blob format
- URI pattern:test://static/resource/{odd_number}
- Content: Base64 encoded binary data

- Basic prompt without arguments
- Returns: Single message exchange

- Advanced prompt demonstrating argument handling
- Required arguments:

- temperature(number): Temperature setting

- Demonstrates embedding resource references in prompts
- Required arguments:

- resourceId(number): ID of the resource to embed (1-100)

The server sends random-leveled log messages every 15 seconds, e.g.:

{ "method": "notifications/message", "params": { "level": "info", "data": "Info-level message" } }

Usage with Claude Desktop (usesstdio Transport)

{ "mcpServers": { "everything": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-everything" ] } } }

For quick installation, use of of the one-click install buttons below...

For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressingCtrl + Shift + Pand typingPreferences: Open User Settings (JSON).

Optionally, you can add it to a file called.vscode/mcp.jsonin your workspace. This will allow you to share the configuration with others.

Note that themcpkey is not needed in the.vscode/mcp.jsonfile.

{ "mcp": { "servers": { "everything": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-everything"] } } } }

Running from source withHTTP+SSE Transport(deprecated as of2025-03-26)

cd src/everything npm install npm run start:sse

Run from source withStreamable HTTP Transport

cd src/everything npm install npm run start:streamableHttp

npm install -g @modelcontextprotocol/server-everything@latest

npx @modelcontextprotocol/server-everything

npx @modelcontextprotocol/server-everything stdio

npx @modelcontextprotocol/server-everything sse

npx @modelcontextprotocol/server-everything streamableHttp

Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB