MCP Test Servers

v1.0.0Developer Toolsstable

MCP server for mcp test servers

mcp-test-serversmcpai-integration
Share:
41
Stars
0
Downloads
0
Weekly
0/5

What is MCP Test Servers?

MCP Test Servers is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for mcp test servers

MCP server for mcp test servers

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP server for mcp test servers

Use Cases

Test MCP server implementations.
msfeldstein

Maintainer

LicenseMIT
Languagejavascript
Versionv1.0.0
UpdatedMar 18, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcp-test-servers

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCP Test Servers

MCP Test Servers is a collection of reference and test server implementations for the Model Context Protocol, designed to help developers validate their MCP clients and explore the full range of MCP features. The package includes an 'everything' server that demonstrates all MCP capabilities — tools, resources, prompts, progress notifications, elicitation workflows, dynamic tool toggling, and environment variable access — in a single configurable endpoint. It is most useful during MCP client development or when learning how to build your own MCP server.

Prerequisites

  • Node.js installed (any recent LTS version)
  • npm or npx available on your PATH
  • Claude Desktop, Cursor, or another MCP-compatible client for testing
1

Choose a server to run

The package provides multiple test servers. The most feature-complete one is 'everything'. Other options include 'ping' for minimal testing.

# List available servers by running the package with no arguments
npx -y @msfeldstein/mcp-test-servers
2

Configure Claude Desktop for the 'everything' server

Add the everything server to your Claude Desktop MCP config to get access to all test tools, resources, and prompts.

{
  "mcpServers": {
    "mcp-test-everything": {
      "command": "npx",
      "args": ["-y", "@msfeldstein/mcp-test-servers", "everything"],
      "env": {
        "MY_ENV_VAR": "My Special Token"
      }
    }
  }
}
3

Configure a minimal ping server

For lightweight connectivity testing, use the ping server which exposes just a simple_ping tool.

{
  "mcpServers": {
    "mcp-test-ping": {
      "command": "npx",
      "args": ["-y", "@msfeldstein/mcp-test-servers", "ping"]
    }
  }
}
4

Restart Claude Desktop

Quit and reopen Claude Desktop to load the test server. You should see test tools appear in the tools panel.

5

Run a comprehensive test

Ask Claude to run all test tools to verify your MCP client's capability handling.

MCP Test Servers Examples

Client configuration

Claude Desktop config running the 'everything' server with an example environment variable to test env var access.

{
  "mcpServers": {
    "mcp-test-everything": {
      "command": "npx",
      "args": ["-y", "@msfeldstein/mcp-test-servers", "everything"],
      "env": {
        "MY_ENV_VAR": "My Special Token"
      }
    }
  }
}

Prompts to try

Example prompts to exercise the test server's tools, resources, and prompts.

- "Run simple_ping and tell me if the MCP server responds"
- "Call echo_env_var to verify it can read MY_ENV_VAR"
- "Use long_running_progress to demonstrate a 20-second task with progress updates"
- "Call get_mixed_resources and show me the returned text and images"
- "Toggle the dynamic tool on and off using toggle_dynamic_tool"

Troubleshooting MCP Test Servers

npx fails to find the package or returns version errors

Run 'npm cache clean --force' and retry. The -y flag on npx should auto-confirm installation. If the package name has changed, check the repository's README for the current published package name.

Tools appear in config but are not visible in Claude Desktop

Verify the server name argument (e.g., 'everything' or 'ping') is correctly passed as the second element in the args array. Restart Claude Desktop fully after any config change.

echo_env_var returns empty or undefined

Environment variables must be declared in the env block of your MCP config. Variables from your shell environment are not automatically passed through. Add MY_ENV_VAR (or any variable you want to test) explicitly in the env section.

Frequently Asked Questions about MCP Test Servers

What is MCP Test Servers?

MCP Test Servers is a Model Context Protocol (MCP) server that mcp server for mcp test servers It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCP Test Servers?

Follow the installation instructions on the MCP Test Servers GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCP Test Servers?

MCP Test Servers works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCP Test Servers free to use?

Yes, MCP Test Servers is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcp-test-servers": { "command": "npx", "args": ["-y", "mcp-test-servers"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MCP Test Servers?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides