MCP (Model Context Protocol) enables clients to interact with servers that expose tools, resources, prompts, and dynamic behaviors in a standardized way. It lets you test, automate, and validate how an MCP-enabled server responds to structured requests, making it easier to verify feature coverage, performance, and integration with clients like dashboards or chat agents.

How to use

To use an MCP server, install or run the MCP test server locally and connect your MCP client to it. You can exercise tools, elicitation prompts, resources (text, images, and more), and dynamic tool behavior. Start with the Everything server to explore all MCP capabilities, then try individual servers to isolate specific features.

How to install

Prerequisites: ensure you have Node.js installed on your system. You typically use Node's package manager to run the MCP test servers.

# Quick start: run the Everything server
npx -y @msfeldstein/mcp-test-servers everything

If you prefer to install a specific server via CLI

npx -y @msfeldstein/mcp-test-servers <server>

## Additional sections

Configuration notes and usage details accompany each server. In this test setup, you can pass environment variables to tailor behavior. For example, MY\_ENV\_VAR can be set to customize server responses during tests.

## Available tools

### echo\_with\_params

A tool that echoes a message with options to repeat the message a specified number of times and to convert the text to uppercase or keep the original case. Provide a message, a repeat\_count, and an uppercase flag to customize the output.

### simple\_ping

A basic ping tool that responds with a pong, useful for basic connectivity tests.

### get\_mixed\_resources

A tool that returns a mixture of content types in a single response, including text and a small binary resource such as an image.

### test\_all\_elicitations

A tool that demonstrates MCP elicitation by requesting multiple forms of input (string, boolean, number, and enum) and then summarizes the collected data.

### toggle\_dynamic\_tool

A control tool that enables and disables a dynamic feature at runtime, allowing you to verify dynamic tool availability and behavior.

### echo\_mcp\_roots

A tool that returns the JSON representation of the MCP roots provided by the client, useful for debugging root mappings.

### echo\_env\_var

A tool that echoes the value of a configured environment variable to verify environment propagation.

### long\_running\_progress

A progress-based tool that simulates a long-running task, providing progress updates at intervals and a final completion message.

### long\_running\_progress

A tool that simulates a long-running task, providing progress updates at intervals and a final completion message.

### docs\_txt

A text resource tool that returns comprehensive documentation about the server when requested.

### test\_image

A tool that returns a small test image in PNG format as a resource.

### simple\_greeting

A prompt-like endpoint that returns a friendly greeting message.

### personalized\_message

A prompt that returns a personalized message using supplied name and topic parameters.

### everything

A comprehensive server that wires together multiple MCP features to provide end-to-end testing of tools, resources, prompts, elicitation, and dynamic behavior.