strava-activity-mcp-server 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

strava_activity_mcp_server-0.1.1.dist-info/METADATA

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: strava-activity-mcp-server
+Version: 0.1.1
+Summary: Add your description here
+License-File: LICENSE
+Requires-Python: >=3.13
+Requires-Dist: build>=1.3.0
+Requires-Dist: mcp[cli]>=1.16.0
+Requires-Dist: twine>=6.2.0
+Description-Content-Type: text/markdown
+
+# strava-activity-mcp-server
+
+A small Model Context Protocol (MCP) server that exposes your Strava athlete data to language-model tooling.
+
+This package provides a lightweight MCP server which communicates with the Strava API and exposes a few helper tools (authorization URL, token exchange/refresh, and fetching athlete activities) that language models or other local tools can call.
+
+The project is intended to be used locally (for example with Claude MCP integrations) and is published on PyPI as `strava-activity-mcp-server`.
+
+## Installation
+
+Install from PyPI with pip (recommended inside a virtual environment):
+
+```powershell
+pip install strava-activity-mcp-server
+```
+
+## Requirements
+
+- Python >= 3.13 (see `pyproject.toml`)
+- The package depends on `mcp[cli]` and `requests` (installed from PyPI).
+
+## Quick start
+
+After installing, you can run the MCP server using the provided console script or by importing and calling `main()`.
+
+Run via the console script (entry point defined in `pyproject.toml`):
+
+```powershell
+strava-activity-mcp-server
+```
+
+Or, from Python:
+
+```python
+from strava_activity_mcp_server import main
+main()
+```
+
+By default the server starts the MCP runtime; when used with an MCP-aware client (for example Claude MCP integrations) the exposed tools become callable.
+
+## Authentication (Strava OAuth)
+
+This server requires Strava OAuth credentials to access athlete data. You will need:
+
+- STRAVA_CLIENT_ID
+- STRAVA_CLIENT_SECRET
+- STRAVA_REFRESH_TOKEN (or a short-lived access token obtained from the authorization flow)
+
+Steps:
+
+1. Create a Strava API application at https://www.strava.com/settings/api and note your Client ID and Client Secret. Use `localhost` as the Authorization Callback Domain.
+2. Open the authorization URL produced by the `strava://auth/url` tool (see Tools below) in a browser to obtain an authorization code.
+3. Exchange the code for tokens using `strava://auth/token` or use the included helper to save refresh/access tokens to your environment.
+
+For local testing you can also manually set the environment variables before running the server:
+
+```powershell
+$env:STRAVA_CLIENT_ID = "<your client id>";
+$env:STRAVA_CLIENT_SECRET = "<your client secret>";
+$env:STRAVA_REFRESH_TOKEN = "<your refresh token>";
+strava-activity-mcp-server
+```
+
+Note: Keep secrets out of version control. Use a `.env` file and a tool such as `direnv` or your system secrets manager for convenience.
+
+## Exposed Tools (what the server provides)
+
+The MCP server exposes the following tools (tool IDs shown):
+
+- `strava://auth/url` — Build the Strava OAuth authorization URL. Input: `client_id` (int). Output: URL string to open in a browser.
+- `strava://auth/token` — Exchange an authorization code for access + refresh tokens. Inputs: `code` (str), `client_id` (int), `client_secret` (str). Output: token dict (with `access_token`, `refresh_token`).
+- `strava://athlete/stats` — Fetch recent athlete activities. Input: `token` (str). Output: JSON with activity list.
+
+These tools map to the functions implemented in `src/strava_activity_mcp_server/strava_activity_mcp_server.py` and are intended to be called by MCP clients.
+
+## Example flows
+
+1) Get an authorization URL and retrieve tokens
+
+- Call `strava://auth/url` with your `client_id` and open the returned URL in your browser.
+- After authorizing, Strava will provide a `code`. Call `strava://auth/token` with `code`, `client_id`, and `client_secret` to receive `access_token` and `refresh_token`.
+
+2) Fetch recent activities
+
+- Use `strava://athlete/stats` with a valid access token. If the access token is expired, use the refresh flow to get a new access token.
+
+## Developer notes
+
+- The package entry point calls `mcp.run()` which runs the MCP server. If you want to change transport or logging settings, modify `src/strava_activity_mcp_server/__init__.py` or `strava_activity_mcp_server.py`.
+- The code uses the `requests` library for HTTP calls.
+
+
+### Client config example and quick inspector test
+
+Any MCP-capable client can launch the server using a config similar to the following (example file often called `config.json`):
+
+```json
+{
+	"command": "uvx",
+	"args": [
+		"strava-activity-mcp-server"
+	]
+}
+```
+
+To quickly test the server using the Model Context Protocol inspector tool, run:
+
+```powershell
+npx @modelcontextprotocol/inspector uvx strava-mcp-server
+```
+
+This will attempt to start the server with the `uvx` transport and connect the inspector to the running MCP server instance named `strava-mcp-server`.
+
+
+## Contributing
+
+Contributions are welcome. Please open issues or pull requests that include a clear description and tests where applicable.
+
+## License
+
+This project is licensed under the GNU GENERAL PUBLIC LICENSE — see the `LICENSE` file for details.
+
+## Links
+
+- Source: repository root
+- Documentation note: see `ref/mcp_pypi_example.md` for an example MCP configuration

{strava_activity_mcp_server-0.1.0.dist-info → strava_activity_mcp_server-0.1.1.dist-info}/RECORD

@@ -1,8 +1,8 @@
 strava_activity_mcp_server/__init__.py,sha256=NgXC8CeBg0qFRHdZJJKjQlX9_RwSETJ9O6PNy0leOTI,107
 strava_activity_mcp_server/__main__.py,sha256=SAdVoObdjb5UP4MY-Y2_uCXpnthB6hgxlb1KNVNgOrc,58
 strava_activity_mcp_server/strava_activity_mcp_server.py,sha256=1Xvo763lIP9m9lBoAYZ2Al86KXw2ozdMSkF_bWl_JxM,3245
-strava_activity_mcp_server-0.1.0.dist-info/METADATA,sha256=cYlysawB9SAJX7FcPBIUUUsewHFObVu-DqDkOgpkcvQ,497
-strava_activity_mcp_server-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-strava_activity_mcp_server-0.1.0.dist-info/entry_points.txt,sha256=F6PO_DBSThhtmX2AC-tu2MIiCJkGi31LCaQJxfUzZ5g,79
-strava_activity_mcp_server-0.1.0.dist-info/licenses/LICENSE,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
-strava_activity_mcp_server-0.1.0.dist-info/RECORD,,
+strava_activity_mcp_server-0.1.1.dist-info/METADATA,sha256=4H0iet9CoT4KkKhLTV36M9q9Q1zRAgTaCHdJ2-exCbA,5189
+strava_activity_mcp_server-0.1.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+strava_activity_mcp_server-0.1.1.dist-info/entry_points.txt,sha256=F6PO_DBSThhtmX2AC-tu2MIiCJkGi31LCaQJxfUzZ5g,79
+strava_activity_mcp_server-0.1.1.dist-info/licenses/LICENSE,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
+strava_activity_mcp_server-0.1.1.dist-info/RECORD,,

strava_activity_mcp_server-0.1.0.dist-info/METADATA

@@ -1,21 +0,0 @@
-Metadata-Version: 2.4
-Name: strava-activity-mcp-server
-Version: 0.1.0
-Summary: Add your description here
-License-File: LICENSE
-Requires-Python: >=3.13
-Requires-Dist: build>=1.3.0
-Requires-Dist: mcp[cli]>=1.16.0
-Requires-Dist: twine>=6.2.0
-Description-Content-Type: text/markdown
-
-# strava-mcp-server
-MCP server that retrieves user activity data from Strava.
-
-.venv\Scripts\activate
-
-uv init --build-backend "hatchling"
-
-uv add mcp["cli"]
-
-uv run mcp dev scr/strava_mcp_server/strava_mcp_server.py