README.md•2.84 kB
# MCP Test Server
Lightweight MCP test server for verifying client connectivity, with tools and prompts for integration. Try it at [kukayay.com](https://test.kukapay.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:
```json
{
"McpServers": {
"Test Server": {
"url": "https://test.kukapay.com/api/mcp"
}
}
}
```
- Stdio Transport
For clients requiring stdio transport, use `mcp-remote`:
```json
{
"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):
```json
{
"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:
```bash
git clone https://github.com/kukapay/mcp-test-server.git
cd mcp-test-server
```
2. Install dependencies:
```bash
npm install
```
3. Start the development server:
```bash
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
```json
{
"McpServers": {
"Test Server": {
"url": "http://localhost:3000/api/mcp"
}
}
}
```
- Stdio Transport
```json
{
"McpServers": {
"Test Server": {
"command": "npx",
"args": ["mcp-remote", "-y", "http://localhost:3000/api/mcp"]
}
}
}
```
- HTTP SSE Transport (Legacy)
```json
{
"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](LICENSE) for details.