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.
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?
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?
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?
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?
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?
Where can I find more information about the Model Context Protocol?
Refer to the official documentation and specifications of the Model Context Protocol.