Create wiki page 'MCP Clients'

2026-05-14 19:44:44 +00:00
parent b26a8f140e
commit a34d2897bd
1 changed files with 113 additions and 0 deletions
@@ -0,0 +1,113 @@
+# 🔌 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)
+
+```json
+{
+  "mcpServers": {
+    "strava": {
+      "command": "uvx",
+      "args": ["--from", "strava-mcp-server-hnrx", "server"]
+    }
+  }
+}
+```
+
+### HTTP Mode (if running separately)
+
+```json
+{
+  "mcpServers": {
+    "strava": {
+      "url": "http://localhost:8000/mcp",
+      "transport": "streamable-http"
+    }
+  }
+}
+```
+
+---
+
+## OpenWebUI
+
+1. Start the server in HTTP mode:
+   ```bash
+   MCP_TRANSPORT=http uvx --from strava-mcp-server-hnrx server
+   ```
+2. In OpenWebUI → **Settings** → **Tools** → Add MCP Server:
+   - **URL**: `http://localhost:8000/mcp`
+   - **Transport**: Streamable HTTP
+
+---
+
+## MCP Inspector (for testing)
+
+The [MCP Inspector](https://github.com/modelcontextprotocol/inspector) is the best tool for testing and debugging.
+
+**Option A — STDIO (fastest, no server needed):**
+```bash
+npx @modelcontextprotocol/inspector uvx --from strava-mcp-server-hnrx server
+```
+
+**Option B — HTTP (if server is already running):**
+1. Open [https://inspector.modelcontextprotocol.io/](https://inspector.modelcontextprotocol.io/)
+2. Set Transport to **Streamable HTTP**
+3. Enter URL: `http://localhost:8000/mcp`
+
+---
+
+## Cursor
+
+Add to your Cursor MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "strava": {
+      "command": "uvx",
+      "args": ["--from", "strava-mcp-server-hnrx", "server"]
+    }
+  }
+}
+```
+
+---
+
+## Docker + Any HTTP Client
+
+```bash
+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](Home)*