strava-activity-mcp-server 0.1.7__tar.gz → 0.1.9__tar.gz

{strava_activity_mcp_server-0.1.7 → strava_activity_mcp_server-0.1.9}/.python-version

@@ -1 +1 @@
-3.13
+3.13

{strava_activity_mcp_server-0.1.7 → strava_activity_mcp_server-0.1.9}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: strava-activity-mcp-server
-Version: 0.1.7
-Summary: Trying to implement environment variables for client_id
+Version: 0.1.9
+Summary: STRAVA ACTIVITY MCP SERVER
 License-File: LICENSE
 Requires-Python: >=3.10
 Requires-Dist: build>=1.3.0
@@ -14,6 +14,10 @@ Description-Content-Type: text/markdown
 [![License: GNU](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://opensource.org/licenses/gpl-3-0)
 [![Python 3.13](https://img.shields.io/badge/python-3.13-blue?logo=python&logoColor=white)](https://www.python.org/downloads/release/python-3130/)
 
+![image](https://github.com/user-attachments/assets/4bb214ca-1132-4e63-9390-d6eaddab50be)
+
+
+
 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.
@@ -39,7 +43,7 @@ After installing, you can run the MCP server using the provided console script o
 
 Run via the console script (entry point defined in `pyproject.toml`):
 
-```powershell
+```cmd
 strava-activity-mcp-server
 ```
 
@@ -63,27 +67,21 @@ This server requires Strava OAuth credentials to access athlete data. You will n
 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.
+2. Open the authorization URL produced by the `strava://auth/url` tool (see IMAGE below) in a browser to obtain an authorization code.
 
-For local testing you can also manually set the environment variables before running the server:
+   ![auth](https://github.com/user-attachments/assets/a348ccc7-a4be-49fb-8f79-b88f9d80cfc9)
 
-```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
-```
+3. Copy the code from the redirected URL (Image below) or use the included helper to save refresh/access tokens to your environment.
+
+   ![code](https://github.com/user-attachments/assets/0bb54edb-c9f9-4416-8fb2-c7e0a38d11c9)
 
-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.
+- `strava://athlete/stats` — Fetch recent athlete activities. Input: `client_id` (int), `client_secret` (str), `access_token` (str) and obtained `code` from URL generated by `strava://auth/url`. 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.
 
@@ -92,28 +90,27 @@ These tools map to the functions implemented in `src/strava_activity_mcp_server/
 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`.
+- After authorizing, Strava will provide a `code`.
 
 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`):
+Any MCP-capable client can launch the server using a config similar to the following (example file often called `config.json`. Be sure to enter your values here):
 
 ```json
 {
-	"command": "uvx",
-	"args": [
-		"strava-activity-mcp-server"
-	]
+  "command": "uvx",
+  "args": [
+    "strava-activity-mcp-server"
+  ],
+  "env": {
+    "STRAVA_CLIENT_ID": "12345",
+    "STRAVA_CLIENT_SECRET": "e1234a12d12345f12c1f12345a123bba1d12c1",
+    "STRAVA_REFRESH_TOKEN": "1a123eda1cfd12345678987db2db1bda234c38"
+  }
 }
 ```
 
@@ -141,3 +138,4 @@ This project is licensed under the GNU GENERAL PUBLIC LICENSE — see the `LICEN
 
 
 
+

{strava_activity_mcp_server-0.1.7 → strava_activity_mcp_server-0.1.9}/README.md

@@ -3,6 +3,10 @@
 [![License: GNU](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://opensource.org/licenses/gpl-3-0)
 [![Python 3.13](https://img.shields.io/badge/python-3.13-blue?logo=python&logoColor=white)](https://www.python.org/downloads/release/python-3130/)
 
+![image](https://github.com/user-attachments/assets/4bb214ca-1132-4e63-9390-d6eaddab50be)
+
+
+
 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.
@@ -28,7 +32,7 @@ After installing, you can run the MCP server using the provided console script o
 
 Run via the console script (entry point defined in `pyproject.toml`):
 
-```powershell
+```cmd
 strava-activity-mcp-server
 ```
 
@@ -52,27 +56,21 @@ This server requires Strava OAuth credentials to access athlete data. You will n
 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.
+2. Open the authorization URL produced by the `strava://auth/url` tool (see IMAGE below) in a browser to obtain an authorization code.
 
-For local testing you can also manually set the environment variables before running the server:
+   ![auth](https://github.com/user-attachments/assets/a348ccc7-a4be-49fb-8f79-b88f9d80cfc9)
 
-```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
-```
+3. Copy the code from the redirected URL (Image below) or use the included helper to save refresh/access tokens to your environment.
+
+   ![code](https://github.com/user-attachments/assets/0bb54edb-c9f9-4416-8fb2-c7e0a38d11c9)
 
-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.
+- `strava://athlete/stats` — Fetch recent athlete activities. Input: `client_id` (int), `client_secret` (str), `access_token` (str) and obtained `code` from URL generated by `strava://auth/url`. 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.
 
@@ -81,28 +79,27 @@ These tools map to the functions implemented in `src/strava_activity_mcp_server/
 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`.
+- After authorizing, Strava will provide a `code`.
 
 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`):
+Any MCP-capable client can launch the server using a config similar to the following (example file often called `config.json`. Be sure to enter your values here):
 
 ```json
 {
-	"command": "uvx",
-	"args": [
-		"strava-activity-mcp-server"
-	]
+  "command": "uvx",
+  "args": [
+    "strava-activity-mcp-server"
+  ],
+  "env": {
+    "STRAVA_CLIENT_ID": "12345",
+    "STRAVA_CLIENT_SECRET": "e1234a12d12345f12c1f12345a123bba1d12c1",
+    "STRAVA_REFRESH_TOKEN": "1a123eda1cfd12345678987db2db1bda234c38"
+  }
 }
 ```
 
@@ -130,3 +127,4 @@ This project is licensed under the GNU GENERAL PUBLIC LICENSE — see the `LICEN
 
 
 
+

{strava_activity_mcp_server-0.1.7 → strava_activity_mcp_server-0.1.9}/pyproject.toml

@@ -1,18 +1,18 @@
-[project]
-name = "strava-activity-mcp-server"
-version = "0.1.7"
-description = "Trying to implement environment variables for client_id"
-readme = "README.md"
-requires-python = ">=3.10"
-dependencies = [
-    "build>=1.3.0",
-    "mcp[cli]>=1.16.0",
-    "twine>=6.2.0",
-]
-
-[project.scripts]
-strava-activity-mcp-server = "strava_activity_mcp_server:main"
-
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
+[project]
+name = "strava-activity-mcp-server"
+version = "0.1.9"
+description = "STRAVA ACTIVITY MCP SERVER"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "build>=1.3.0",
+    "mcp[cli]>=1.16.0",
+    "twine>=6.2.0",
+]
+
+[project.scripts]
+strava-activity-mcp-server = "strava_activity_mcp_server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

{strava_activity_mcp_server-0.1.7 → strava_activity_mcp_server-0.1.9}/src/strava_activity_mcp_server/__init__.py

@@ -1,4 +1,4 @@
-from .strava_activity_mcp_server import mcp
-def main() -> None:
-    """Run the MCP server."""
+from .strava_activity_mcp_server import mcp
+def main() -> None:
+    """Run the MCP server."""
     mcp.run()

strava_activity_mcp_server-0.1.9/src/strava_activity_mcp_server/strava_activity_mcp_server.py

@@ -0,0 +1,100 @@
+import sys
+import os
+from mcp.server.fastmcp import FastMCP  # Import FastMCP, the quickstart server base
+mcp = FastMCP("Strava")  # Initialize an MCP server instance with a descriptive name
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
+import requests
+import urllib.parse
+
+@mcp.tool("strava://auth/url")
+
+def get_auth_url(client_id: int | None = None):
+    """Return the Strava OAuth authorization URL. If client_id is not provided,
+    read it from the STRAVA_CLIENT_ID environment variable."""
+    if client_id is None:
+        client_id_env = os.getenv("STRAVA_CLIENT_ID")
+        if not client_id_env:
+            return {"error": "STRAVA_CLIENT_ID environment variable is not set"}
+        try:
+            client_id = int(client_id_env)
+        except ValueError:
+            return {"error": "STRAVA_CLIENT_ID must be an integer"}
+
+    params = {
+        "client_id": client_id,
+        "response_type": "code",
+        "redirect_uri": "https://developers.strava.com/oauth2-redirect/",
+        "approval_prompt": "force",
+        "scope": "read,activity:read_all",
+    }
+    return "https://www.strava.com/oauth/authorize?" + urllib.parse.urlencode(params)
+
+
+
+@mcp.tool("strava://athlete/stats")
+def get_athlete_stats(
+    code: str,
+    client_id: int | None = None,
+    client_secret: str | None = None,) -> dict:
+        
+    #'''Exchange an authorization code for access + refresh tokens.'''
+        if not code:
+            return {"error": "authorization code is required"}
+    
+        if client_id is None:
+            client_id_env = os.getenv("STRAVA_CLIENT_ID")
+            if not client_id_env:
+                return {"error": "STRAVA_CLIENT_ID environment variable is not set"}
+            try:
+                client_id = int(client_id_env)
+            except ValueError:
+                return {"error": "STRAVA_CLIENT_ID must be an integer"}
+    
+        if client_secret is None:
+            client_secret_env = os.getenv("STRAVA_CLIENT_SECRET")
+            if not client_secret_env:
+                return {"error": "STRAVA_CLIENT_SECRET environment variable is not set"}
+            try:
+                client_secret = str(client_secret_env)
+            except ValueError:
+                return {"error": "STRAVA_CLIENT_SECRET must be a string"}
+
+
+        resp = requests.post(
+            "https://www.strava.com/oauth/token",
+            data={
+            "client_id": client_id,
+            "client_secret": client_secret,
+            "code": code,
+            "grant_type": "authorization_code",
+        },
+    )
+        try:
+            resp.raise_for_status()
+        except requests.HTTPError:
+            return {"error": "token request failed", "status_code": resp.status_code, "response": resp.text}
+        except Exception as e:
+            return {"error": "token request failed", "status_code": resp.status_code, "response": resp.text, "error": str(e)}
+
+        tokens = resp.json()
+    # Print tokens for debugging (optional)
+        print(tokens)
+
+        access_token = tokens.get("access_token")
+        refresh_token = tokens.get("refresh_token")
+
+
+    #return {"tokens": tokens, "access_token": access_token, "refresh_token": refresh_token}
+
+        url = "https://www.strava.com/api/v3/athlete/activities?per_page=60"
+        headers = {
+            "accept": "application/json",
+            "authorization": f"Bearer {access_token}"
+            }
+
+        response = requests.get(url, headers=headers)
+
+        return response.json()
+
+if __name__ == "__main__":
+    mcp.run(transport="stdio")  # Run the server, using standard input/output for communication

{strava_activity_mcp_server-0.1.7 → strava_activity_mcp_server-0.1.9}/uv.lock

@@ -1,5 +1,5 @@
 version = 1
-revision = 3
+revision = 2
 requires-python = ">=3.10"
 
 [[package]]
@@ -1031,7 +1031,7 @@ wheels = [
 
 [[package]]
 name = "strava-activity-mcp-server"
-version = "0.1.7"
+version = "0.1.9"
 source = { editable = "." }
 dependencies = [
     { name = "build" },

strava_activity_mcp_server-0.1.7/src/strava_activity_mcp_server/strava_activity_mcp_server.py

@@ -1,222 +0,0 @@
-import sys
-import os
-from mcp.server.fastmcp import FastMCP  # Import FastMCP, the quickstart server base
-mcp = FastMCP("Strava")  # Initialize an MCP server instance with a descriptive name
-sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
-import requests
-import urllib.parse
-
-@mcp.tool("strava://auth/url")
-
-def get_auth_url(client_id: int | None = None):
-    """Return the Strava OAuth authorization URL. If client_id is not provided,
-    read it from the STRAVA_CLIENT_ID environment variable."""
-    if client_id is None:
-        client_id_env = os.getenv("STRAVA_CLIENT_ID")
-        if not client_id_env:
-            return {"error": "STRAVA_CLIENT_ID environment variable is not set"}
-        try:
-            client_id = int(client_id_env)
-        except ValueError:
-            return {"error": "STRAVA_CLIENT_ID must be an integer"}
-
-    params = {
-        "client_id": client_id,
-        "response_type": "code",
-        "redirect_uri": "https://developers.strava.com/oauth2-redirect/",
-        "approval_prompt": "force",
-        "scope": "read,activity:read_all",
-    }
-    return "https://www.strava.com/oauth/authorize?" + urllib.parse.urlencode(params)
-
-
-
-@mcp.tool("strava://auth/token")
-def exchange_code_for_token(
-    code: str,
-    client_id: int | None = None,
-    client_secret: str | None = None,
-) -> dict:
-    """Exchange an authorization code for access + refresh tokens."""
-    if not code:
-        return {"error": "authorization code is required"}
-    
-    if client_id is None:
-        client_id_env = os.getenv("STRAVA_CLIENT_ID")
-        if not client_id_env:
-            return {"error": "STRAVA_CLIENT_ID environment variable is not set"}
-        try:
-            client_id = int(client_id_env)
-        except ValueError:
-            return {"error": "STRAVA_CLIENT_ID must be an integer"}
-    
-    if client_secret is None:
-        client_secret_env = os.getenv("STRAVA_CLIENT_SECRET")
-        if not client_secret_env:
-            return {"error": "STRAVA_CLIENT_SECRET environment variable is not set"}
-        try:
-            client_secret = str(client_secret_env)
-        except ValueError:
-            return {"error": "STRAVA_CLIENT_SECRET must be a string"}
-
-    resp = requests.post(
-        "https://www.strava.com/oauth/token",
-        data={
-            "client_id": client_id,
-            "client_secret": client_secret,
-            "code": code,
-            "grant_type": "authorization_code",
-        },
-    )
-    try:
-        resp.raise_for_status()
-    except requests.HTTPError:
-        return {"error": "token request failed", "status_code": resp.status_code, "response": resp.text}
-
-    tokens = resp.json()
-    # Print tokens for debugging (optional)
-    print(tokens)
-
-    access_token = tokens.get("access_token")
-    refresh_token = tokens.get("refresh_token")
-
-    return {"tokens": tokens, "access_token": access_token, "refresh_token": refresh_token}
-
-
-def refresh_access_token(
-    refresh_token: str,
-    client_id: int,
-    client_secret: str,
-) -> dict:
-    """Refresh an access token using a refresh token."""
-    if not refresh_token:
-        return {"error": "refresh_token is required"}
-
-    resp = requests.post(
-        "https://www.strava.com/oauth/token",
-        data={
-            "client_id": client_id,
-            "client_secret": client_secret,
-            "grant_type": "refresh_token",
-            "refresh_token": refresh_token,
-        },
-    )
-    try:
-        resp.raise_for_status()
-    except requests.HTTPError:
-        return {"error": "refresh request failed", "status_code": resp.status_code, "response": resp.text}
-
-    new_tokens = resp.json()
-    # Print new tokens for debugging (optional)
-    print(new_tokens)
-    return new_tokens
-
-
-@mcp.tool("strava://athlete/stats")
-def _get_env_client_credentials() -> tuple[int | None, str | None]:
-    """Read client id and secret from environment and return (client_id, client_secret).
-
-    client_id will be returned as int if present and valid, otherwise None.
-    """
-    client_id = None
-    client_secret = os.getenv("STRAVA_CLIENT_SECRET")
-    client_id_env = os.getenv("STRAVA_CLIENT_ID")
-    if client_id_env:
-        try:
-            client_id = int(client_id_env)
-        except ValueError:
-            client_id = None
-    return client_id, client_secret
-
-
-def _ensure_access_token(token_or_tokens: object) -> tuple[str | None, dict | None]:
-    """Given either an access token string or the token dict returned by the token endpoints,
-    return a tuple (access_token, tokens_dict).
-
-    If a dict is provided and contains no valid access_token but has a refresh_token,
-    attempt to refresh using env client credentials. Returns (access_token, tokens_dict) or (None, None)
-    on failure.
-    """
-    # If token_or_tokens is a string, assume it's an access token.
-    if isinstance(token_or_tokens, str):
-        return token_or_tokens, None
-
-    # If it's a dict-like object, try to find access_token
-    if isinstance(token_or_tokens, dict):
-        access_token = token_or_tokens.get("access_token")
-        if access_token:
-            return access_token, token_or_tokens
-
-        # try refresh flow
-        refresh_token = token_or_tokens.get("refresh_token")
-        client_id = token_or_tokens.get("client_id")
-        client_secret = token_or_tokens.get("client_secret")
-
-        # fallback to env vars if client id/secret not in the dict
-        if not client_id or not client_secret:
-            env_client_id, env_client_secret = _get_env_client_credentials()
-            if not client_id:
-                client_id = env_client_id
-            if not client_secret:
-                client_secret = env_client_secret
-
-        if refresh_token and client_id and client_secret:
-            try:
-                new_tokens = refresh_access_token(refresh_token, int(client_id), client_secret)
-            except Exception as e:
-                print(f"refresh failed: {e}")
-                return None, None
-
-            access_token = new_tokens.get("access_token")
-            return access_token, new_tokens
-
-    return None, None
-
-
-@mcp.tool("strava://athlete/stats")
-def get_athlete_stats(token: object) -> object:
-    """Retrieve athlete activities using either an access token string or a token dict.
-
-    If a token dict is provided and the access token is missing/expired, the function will
-    attempt to refresh it (one attempt) using provided refresh token and client credentials
-    (falling back to STRAVA_CLIENT_ID/STRAVA_CLIENT_SECRET environment variables).
-    """
-    access_token, tokens_dict = _ensure_access_token(token)
-    if not access_token:
-        return {"error": "Could not obtain an access token"}
-
-    url = "https://www.strava.com/api/v3/athlete/activities?per_page=60"
-    headers = {
-        "accept": "application/json",
-        "authorization": f"Bearer {access_token}"
-    }
-
-    response = requests.get(url, headers=headers)
-
-    # If unauthorized, try one refresh if we have a refresh token available
-    if response.status_code == 401 and isinstance(token, dict):
-        refresh_token = token.get("refresh_token") or (tokens_dict or {}).get("refresh_token")
-        if refresh_token:
-            client_id = token.get("client_id") or (tokens_dict or {}).get("client_id")
-            client_secret = token.get("client_secret") or (tokens_dict or {}).get("client_secret")
-            if not client_id or not client_secret:
-                env_client_id, env_client_secret = _get_env_client_credentials()
-                client_id = client_id or env_client_id
-                client_secret = client_secret or env_client_secret
-
-            if client_id and client_secret:
-                new_tokens = refresh_access_token(refresh_token, int(client_id), client_secret)
-                new_access = new_tokens.get("access_token")
-                if new_access:
-                    headers["authorization"] = f"Bearer {new_access}"
-                    response = requests.get(url, headers=headers)
-
-    try:
-        response.raise_for_status()
-    except requests.HTTPError:
-        return {"error": "request failed", "status_code": response.status_code, "response": response.text}
-
-    return response.json()
-
-if __name__ == "__main__":
-    mcp.run(transport="stdio")  # Run the server, using standard input/output for communication