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 LICENSE for details.