mcp-test-server

mcp-test-server

3.2

If you are the rightful owner of mcp-test-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The MCP Test Server is a lightweight server designed to verify client connectivity and facilitate integration with various tools and prompts.

MCP Test Server

Lightweight MCP test server for verifying client connectivity, with tools and prompts for integration. Try it at kukayay.com or install locally.

Features

  • Tools:
    • calculate_sum: Sums an array of numbers.
  • Resources:
    • Static: test://data - Returns static test data.
    • Dynamic: user://{userId} - Returns user profile data for a given userId.
  • Prompts:
    • greeting: Generates a personalized greeting based on a name parameter.
  • Transports:
    • Streamable HTTP (recommended for modern MCP clients).
    • Stdio (via mcp-remote for clients requiring stdio transport).
    • HTTP SSE (legacy, removed from MCP standard).

Online Server

Test the server online at https://test.kukapay.com using the following configurations:

  • Streamable HTTP Transport

For clients supporting Streamable HTTP transport:

{
  "McpServers": {
    "Test Server": {
      "url": "https://test.kukapay.com/api/mcp"
    }
  }
}
  • Stdio Transport

For clients requiring stdio transport, use mcp-remote:

{
  "McpServers": {
    "Test Server": {
      "command": "npx",
      "args": ["mcp-remote", "-y", "https://test.kukapay.com/api/mcp"]
    }
  }
}
  • HTTP SSE Transport (Legacy)

For clients supporting HTTP SSE (note: deprecated in MCP standard):

{
  "McpServers": {
    "Test Server": {
      "url": "https://test.kukapay.com/api/sse"
    }
  }
}

Local Installation

Prerequisites

  • Node.js >= 18.x
  • npm >= 9.x

Installation

  1. Clone the repository:

    git clone https://github.com/kukapay/mcp-test-server.git
cd mcp-test-server

  2. Install dependencies:

    npm install

  3. Start the development server:

    npm run dev

    The server will be available at http://localhost:3000.

Configuration

Configure your MCP client to connect to the local server using one of the following transport methods:

  • Streamable HTTP Transport
{
  "McpServers": {
    "Test Server": {
      "url": "http://localhost:3000/api/mcp"
    }
  }
}
  • Stdio Transport
{
  "McpServers": {
    "Test Server": {
      "command": "npx",
      "args": ["mcp-remote", "-y", "http://localhost:3000/api/mcp"]
    }
  }
}
  • HTTP SSE Transport (Legacy)
{
  "McpServers": {
    "Test Server": {
      "url": "http://localhost:3000/api/sse"
    }
  }
}

Client-Specific Configuration

  • Claude Desktop: Add the above configuration to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).
  • Cursor: Add to ~/.cursor/mcp.json.
  • Windsurf: Add to ~/.codeium/windsurf/mcp_config.json.

License

MIT License. See for details.