Demo (Everything) MCP server

Test protocol features and tools for client compatibility.
Back to servers
Setup instructions
Provider
Anthropic
Release date
Nov 19, 2024
Language
TypeScript
Package
Stats
155.5K downloads
65.7K stars

The MCP Everything Server provides a comprehensive testing environment for Model Context Protocol (MCP) clients, implementing various protocol features like prompts, tools, resources, and sampling. This server is primarily designed for testing and demonstration purposes rather than production use.

Installation Options

Using NPM

You can easily install and run the MCP Everything Server using npm:

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

After installation, run the server with:

npx @modelcontextprotocol/server-everything

Running Specific Transport Types

The server supports different transport protocols:

For stdio (default):

npx @modelcontextprotocol/server-everything stdio

For streamable HTTP:

npx @modelcontextprotocol/server-everything streamableHttp

Integration with MCP Clients

Claude Desktop Integration

To use this server with Claude Desktop, add the following configuration to your claude_desktop_config.json file:

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

VS Code Integration

Manual Configuration in VS Code

You can configure the MCP server in VS Code using one of these methods:

User Configuration (Recommended):

  1. Open the Command Palette (Ctrl + Shift + P)
  2. Run MCP: Open User Configuration
  3. Add this configuration to your user mcp.json file:
{
  "servers": {
    "everything": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-everything"]
    }
  }
}

Workspace Configuration:

Create a file at .vscode/mcp.json in your workspace with the same configuration as above.

Available Features and Tools

Tools

The server provides several tools that demonstrate MCP capabilities:

  • echo: Echoes back input messages
  • add: Adds two numbers together
  • longRunningOperation: Demonstrates progress notifications
  • printEnv: Returns all environment variables
  • sampleLLM: Shows LLM sampling capability
  • getTinyImage: Returns a small test image
  • annotatedMessage: Demonstrates content annotations
  • getResourceReference: Provides resource references
  • startElicitation: Initiates interactive inputs
  • structuredContent: Returns structured data

Resources

The server provides 100 test resources:

  • Even-numbered resources: Plaintext format
  • Odd-numbered resources: Binary blob format

These resources support pagination, subscription to updates, and automatic updates every 5 seconds.

Prompts

The server includes demonstration prompts:

  • simple_prompt: Basic prompt without arguments
  • complex_prompt: Advanced prompt with argument handling
  • resource_prompt: Shows embedding resource references

Each prompt demonstrates different MCP capabilities, including multi-turn conversations and resource embedding.

Testing Server Features

You can test the various features by accessing the tools, resources, and prompts through your MCP client. For example, to use the echo tool:

  1. Connect your MCP client to the server
  2. Access the echo tool
  3. Provide a message input
  4. The server will echo back your message

The server also sends random log messages every 15 seconds, which can be useful for testing notification handling in your client.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "everything" '{"command":"npx","args":["-y","@modelcontextprotocol/server-everything"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

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

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

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

3. Restart Claude Desktop for the changes to take effect

Want to 10x your AI skills?

Get a free account and learn to code + market your apps using AI (with or without vibes!).

Nah, maybe later