🔌 MCP Clients

How to connect different MCP clients to the Strava MCP Server.

Transport Modes

The server supports two transport modes:

Mode	Use Case	Start Command
`stdio` (default)	Local clients (Claude Desktop, Cursor, Inspector)	`uvx --from strava-mcp-server-hnrx server`
`http`	Remote clients, Docker, OpenWebUI	`MCP_TRANSPORT=http uvx --from strava-mcp-server-hnrx server`

In HTTP mode, the MCP endpoint is available at: http://localhost:8000/mcp

Claude Desktop

Add the server to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

STDIO Mode (Recommended for local use)

{
  "mcpServers": {
    "strava": {
      "command": "uvx",
      "args": ["--from", "strava-mcp-server-hnrx", "server"]
    }
  }
}

HTTP Mode (if running separately)

{
  "mcpServers": {
    "strava": {
      "url": "http://localhost:8000/mcp",
      "transport": "streamable-http"
    }
  }
}

OpenWebUI

Start the server in HTTP mode:

MCP_TRANSPORT=http uvx --from strava-mcp-server-hnrx server

In OpenWebUI → Settings → Tools → Add MCP Server:
- URL: http://localhost:8000/mcp
- Transport: Streamable HTTP

MCP Inspector (for testing)

The MCP Inspector is the best tool for testing and debugging.

Option A — STDIO (fastest, no server needed):

npx @modelcontextprotocol/inspector uvx --from strava-mcp-server-hnrx server

Option B — HTTP (if server is already running):

Open https://inspector.modelcontextprotocol.io/
Set Transport to Streamable HTTP
Enter URL: http://localhost:8000/mcp

Cursor

Add to your Cursor MCP configuration:

{
  "mcpServers": {
    "strava": {
      "command": "uvx",
      "args": ["--from", "strava-mcp-server-hnrx", "server"]
    }
  }
}

Docker + Any HTTP Client

docker run -d -p 8000:8000 \
  --env-file ~/.config/strava-mcp-server/config.env \
  -e MCP_TRANSPORT=http \
  git.hnrx.net/hnrx/strava-mcp-server:latest

Then connect any MCP-compatible HTTP client to http://<your-host>:8000/mcp.

Back to Home