home / mcp / spec3 mcp server

Spec3 MCP Server

Personal MCP server for spec3 racing!

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "dhevenb-dheven-spec3-mcp-server": {
      "command": "wsl",
      "args": [
        "-e",
        "/home/dhevb/workspaces/spec3-mcp-server/venv/bin/python",
        "/home/dhevb/workspaces/spec3-mcp-server/src/spec3_mcp_server/main.py"
      ]
    }
  }
}

You run a local MCP server on your WSL machine to provide tools for Claude Desktop over the MCP protocol. It’s designed for fast local testing and development, with clear tool endpoints you can invoke from Claude Desktop or other MCP clients.

How to use

Start by connecting Claude Desktop to your local MCP server. You will access a set of predefined tools that perform common tasks such as returning a greeting, echoing messages, reporting server information, and listing available tools. Use the MCP client to invoke a tool by name and pass any required parameters. Each tool runs inside your WSL environment and communicates through the MCP protocol, returning structured results that you can display in Claude Desktop.

How to install

Prerequisites you need on your workstation are: Python 3.10+, Windows Subsystem for Linux (WSL), and Claude Desktop installed on Windows.

Step by step install flow you should follow on your WSL terminal:

bash
# 1. Navigate to the project directory
cd /home/dhevb/workspaces/spec3-mcp-server

# 2. Create and activate a virtual environment
python -m venv venv
source venv/bin/activate

# 3. Install the package in development mode
pip install -e .

# 4. Verify the installation
spec3-mcp-server --help

Configuration and operation notes

This server exposes a set of tools that Claude Desktop can discover and use once you connect. The server runs in a local WSL environment, so your Claude Desktop configuration must execute Python from WSL to reach the MCP server.

Available tools

hello_world

Returns a simple greeting message when invoked. Useful as a basic connectivity and response test tool.

echo_message

Echoes back a provided message with additional formatting to demonstrate parameter passing and string handling.

get_server_info

Returns comprehensive information about the MCP server, including its capabilities, version, and available tools.

list_available_tools

Lists all available tools with descriptions so you know what endpoints you can call from your MCP client.