MCP Test Servers logo

MCP Test Servers

by msfeldstein

A collection of test servers implementing the Model Context Protocol (MCP). These servers provide various functionalities and edge cases for testing MCP clients.

View on GitHub

Last updated: N/A

What is MCP Test Servers?

MCP Test Servers is a repository containing a suite of lightweight servers designed to simulate different scenarios and functionalities within the Model Context Protocol. These servers are intended to aid developers in testing and validating their MCP client implementations.

How to use MCP Test Servers?

To run a server, use the command npx @msfeldstein/mcp-test-servers <server-type>. For example, to run the time server, use npx @msfeldstein/mcp-test-servers time. Some servers, like the 'named' server, require environment variables to be set (e.g., MCP_SERVER_NAME="my-custom-server" npx @msfeldstein/mcp-test-servers named).

Key features of MCP Test Servers

  • Variety of server implementations

  • Simulates different MCP functionalities (tools, resources)

  • Includes edge cases (broken tool, crash on startup, bad parameters)

  • Easy to run with npx

  • Configurable server names via environment variables

Use cases of MCP Test Servers

  • Testing MCP client implementations

  • Validating MCP client behavior under different scenarios

  • Debugging MCP client issues

  • Demonstrating MCP capabilities

  • Exploring MCP edge cases

FAQ from MCP Test Servers

What is MCP?

MCP stands for Model Context Protocol. It's a protocol for accessing data and functionality from remote servers.

How do I run a specific server?

Use the command npx @msfeldstein/mcp-test-servers <server-type>, replacing <server-type> with the name of the server you want to run (e.g., time, resource).

Can I customize the server name?

Yes, for the 'named' server, you can set the MCP_SERVER_NAME environment variable to a custom name.

What are some of the edge cases covered?

The servers include cases like a broken tool that throws an error, a server that crashes on startup, and a server with malformed parameter names.

Where can I find more information about the Model Context Protocol?

Refer to the official documentation and specifications of the Model Context Protocol.