home / mcp / mcp test server

MCP Test Server

A test MCP server with diverse tools, resources, and prompts to exercise MCP clients and scanners.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "anika536-mcp-test": {
      "command": "mcp-test-server",
      "args": []
    }
  }
}

You have a dedicated, test-focused MCP server that provides a variety of tools, resources, and prompts to validate MCP scanners and implementations. This server is designed to be easily discovered by MCP clients and scanners, making it ideal for testing integration, parameter handling, and prompt capabilities in a controlled environment.

How to use

To use this MCP server with an MCP client, connect via a stdio channel using the server executable you run locally. You can list available tools and then invoke any tool to observe how the client and server exchange data and how parameters are validated.

How to install

# Prerequisites
- Python 3.10 or higher (for the server)
- pip (Python package manager)

# From source
# Clone the repository and install the package
git clone <repository-url>
cd mcp-test

# Install the package
pip install .

# Optional: install development dependencies
pip install -e ".[dev]"

Additional sections

Configuration and start commands are provided below to run the server locally and test client interactions. Use the stdio transport to start the server so your MCP client can initialize, list tools, and call tools with structured inputs.

Start the server in one of the following ways. Choose the approach that matches how you prefer to run Python-based MCP servers.

Examples and notes

Common usage patterns include starting the server and using a client to initialize a session, list available tools, and call a tool such as echo to verify round-trips and parameter handling.

Available tools

echo

Echoes the input message to test basic string parameter handling.

add_numbers

Adds two numeric inputs to validate numeric parameter processing.

format_json

Formats a JSON object with a specified indentation level to test object handling.

list_operations

Performs operations on arrays such as sort, reverse, count, and join to exercise list handling and enums.

complex_schema

Processes a nested object with multiple types to test complex schema parsing.

timestamp

Returns the current timestamp in a specified format, testing optional parameters handling.