Create wiki page 'Installation'

2026-05-14 19:43:53 +00:00
parent 1298e19c0b
commit 149b956459
1 changed files with 98 additions and 0 deletions
@@ -0,0 +1,98 @@
+# 📦 Installation
+
+All installation methods for the Strava MCP Server.
+
+---
+
+## Option 1: uvx (Recommended — no install needed)
+
+Run directly from PyPI without installing anything permanently:
+
+```bash
+# Authenticate (once)
+uvx --from strava-mcp-server-hnrx auth
+
+# Run the server
+uvx --from strava-mcp-server-hnrx server
+```
+
+`uvx` downloads, caches, and runs the package in an isolated environment.  
+Requires [uv](https://docs.astral.sh/uv/) (`curl -LsSf https://astral.sh/uv/install.sh | sh`).
+
+---
+
+## Option 2: Docker (Recommended for self-hosting)
+
+A pre-built multi-arch image (amd64/arm64) is automatically published on every release.
+
+```bash
+# Pull the latest image
+docker pull git.hnrx.net/hnrx/strava-mcp-server:latest
+
+# Run with config file
+docker run --rm -p 8000:8000 \
+  --env-file ~/.config/strava-mcp-server/config.env \
+  -e MCP_TRANSPORT=http \
+  git.hnrx.net/hnrx/strava-mcp-server:latest
+```
+
+Pin to a specific version for production stability:
+
+```bash
+docker pull git.hnrx.net/hnrx/strava-mcp-server:v0.1.1
+```
+
+<details>
+<summary>Build from source</summary>
+
+```bash
+git clone https://git.hnrx.net/hnrx/strava-mcp-server.git
+cd strava-mcp-server
+docker build -t strava-mcp-server:latest .
+docker run --rm -p 8000:8000 \
+  --env-file ~/.config/strava-mcp-server/config.env \
+  -e MCP_TRANSPORT=http \
+  strava-mcp-server:latest
+```
+</details>
+
+---
+
+## Option 3: pip / uv add
+
+Install permanently into your Python environment:
+
+```bash
+pip install strava-mcp-server-hnrx
+# or
+uv add strava-mcp-server-hnrx
+```
+
+Then run:
+
+```bash
+auth    # Interactive setup wizard
+server  # Start the MCP server
+```
+
+---
+
+## Option 4: From Source (for Contributors)
+
+```bash
+git clone https://git.hnrx.net/hnrx/strava-mcp-server.git
+cd strava-mcp-server
+
+# Install dependencies
+uv sync
+
+# Authenticate
+uv run auth
+
+# Start the server
+uv run server
+```
+
+---
+
+*Back to [Home](Home)*