MCP Everything

Note: This project was extracted from https://github.com/modelcontextprotocol/servers/tree/main/src/everything to create a standalone implementation.

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.

Installation

Local Installation

Global Installation

Docker

Usage with Claude Desktop

Add to your claude_desktop_config.json:

Components

Tools

1. echo

   • Simple tool to echo back input messages

   • Input:

     • message (string): Message to echo back

   • Returns: Text content with echoed message

2. add

   • Adds two numbers together

   • Inputs:

     • a (number): First number

     • b (number): Second number

   • Returns: Text result of the addition

3. longRunningOperation

   • Demonstrates progress notifications for long operations

   • Inputs:

     • duration (number, default: 10): Duration in seconds

     • steps (number, default: 5): Number of progress steps

   • Returns: Completion message with duration and steps

   • Sends progress notifications during execution

4. sampleLLM

   • 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: Generated LLM response

5. getTinyImage

   • Returns a small test image

   • 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

Resources

The server provides 100 test resources in two formats:

• 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}

  • Content: Base64 encoded binary data

Resource features:

• Supports pagination (10 items per page)

• Allows subscribing to resource updates

• Demonstrates resource templates

• Auto-updates subscribed resources every 5 seconds

Prompts

1. simple_prompt

   • Basic prompt without arguments

   • Returns: Single message exchange

2. complex_prompt

   • Advanced prompt demonstrating argument handling

   • Required arguments:

     • temperature (number): Temperature setting

   • Optional arguments:

     • style (string): Output style preference

   • Returns: Multi-turn conversation with images

Logging

The server sends random-leveled log messages every 15 seconds to demonstrate the logging capabilities of MCP.