mcp-test-server

kukapay/mcp-test-server

3.1

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.

Tools
1
Resources
0
Prompts
0

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.