mcp-test-server

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:

• Stdio Transport

For clients requiring stdio transport, use mcp-remote:

• HTTP SSE Transport (Legacy)

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

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

• Stdio Transport

• HTTP SSE Transport (Legacy)

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.