Which integrations are available for this server?

Offers integration with Windsurf (Codeium's product), with specific configuration paths for adding the MCP server to Windsurf. Enables access to both static and dynamic resources through test:// and user:// URI schemes, with support for multiple transport methods including Streamable HTTP and Stdio.

How do I use mcp-test-server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-test-server calculate the sum of 5, 10, and 15" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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).

Related MCP server: mcp-serverTest

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

Clone the repository:
git clone https://github.com/kukapay/mcp-test-server.git cd mcp-test-server
Install dependencies:
npm install
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.