What is Mcp Test Servers

mcp-test-servers is a Docker container project that provides an Ubuntu environment with SSH access, allowing users to run applications and services in an isolated environment.

Use cases

Use cases include running web applications, testing software in a controlled environment, and providing a sandbox for learning and experimentation with Linux and Docker.

How to use

To use mcp-test-servers, ensure Docker and Docker Compose are installed, create a shared directory, build and start the container using ‘docker-compose up -d’, and access it via SSH or directly through Docker commands.

Key features

Key features include SSH access for secure remote login, direct container access via Docker commands, and a shared directory for easy file exchange between the host and the container.

Where to use

mcp-test-servers can be used in development environments, testing scenarios, and educational purposes where a lightweight and isolated Ubuntu environment is required.

MCP Test Servers

A collection of test servers implementing the Model Context Protocol (MCP).

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

Available Servers

• all-types: Demonstrates various tool parameter types supported by MCP
• bad-param: Server with an intentionally malformed parameter name
• big-response: Server that returns large responses
• broken-tool: Server with intentionally broken tool
• crash-on-startup: Server that crashes on startup
• combined: Server with tools and resources
• duplicate-names: Server with duplicate names for resources
• enum-param: Tool has enum string parameter
• env-check: Checks for SHOULD_RUN environment variable being passed properly
• env-echo: Echoes the environment variables
• image: Tool returns an image of sonic the hedgehog
• long-description: Publicize a very long description configured via env var
• long-running: Server that sends progress notifications every 2 seconds for a 20-second task
• many-resources: Server with multiple resources
• many-tools: Server with 100 tools that each return ‘ack’
• math: Server with basic math function tools (add, subtract, multiply, divide, power, sqrt, factorial)
• named: Server with configurable name via MCP_SERVER_NAME environment variable
• number-param: Tool with a number parameter
• optional-param: Tool has an optional param
• pattern-param: Tool has a parameter with a pattern match
• ping: A simple server that responds with ‘pong’
• resource: Resource server implementation
• roots-echo: Server that demonstrates MCP roots functionality by echoing back the roots provided by the client
• stderr: Server that logs to stderr
• stdout Servert that illegally logs to stdout

Remote Servers

# Streamable HTTP
npm run http-ping

# SSE
npm run sse-ping