statsWR_mcp_server

This MCP server is a Python-based integration for the StatsWR API. It runs under uv (the Python environment launcher) and loads the mcp_src/statsWR_mcp_server.py implementation. The server is configured to point to your project root and the StatsWR client script, and it uses environment variables to control connectivity and timeouts. Once running, the MCP server exposes its capabilities to the hosting model so you can issue commands or requests to fetch statistics from StatsWR and have them responded through the MCP framework. Make sure the environment is set up and the server is enabled in your model/client settings to start routing queries to StatsWR.

Prerequisites

• Python and uv (uv tool) installed on your system
• Access to the StatsWR project and its mcp_server script at mcp_src/statsWR_mcp_server.py
• A running Model Context/Claude Desktop setup that can load MCP servers

Step-by-step installation

1. Prepare the environment

   • Create or activate a Python virtual environment if required by your setup.
   • Ensure uv is installed and accessible in your PATH.

2. Install or verify required dependencies

   • Ensure any Python dependencies required by statsWR_mcp_server.py are installed (as defined by the project, typically via requirements.txt or poetry).

3. Configure MCP server in your Claude/Desktop environment

   • Update or create the configuration file (e.g., claude_desktop_config.json) with the StatsWR MCP server entry:

     { "mcpServers": { "statsWR": { "command": "/Path/to/uv", "args": [ "--directory", "/Path/to/Project/Root/Directory", "run", "mcp_src/statsWR_mcp_server.py" ] } } }

4. Create required environment variables

   • In the project root, create a .env file and define: STATSWR_API_BASE_URL=<STATSWR OFFICIAL API BASE URL>/api/v1 DEFAULT_TIMEOUT=60 PORT=18517 ... (any additional StatsWR-related config values)

5. Start/Restart the MCP server

   • Restart Claude Desktop or your MCP host so it picks up the new configuration.
   • Ensure the statsWR MCP server is enabled in the model's settings.

6. Verify operation

   • Interact with the model and verify that requests intended for StatsWR are routed through the MCP server and that responses are returned correctly.

Tips and common issues:

• Ensure the path to uv and the project directory are correct in the configuration. Incorrect paths will prevent the MCP server from starting.
• If you encounter connection errors, confirm that STATSWR_API_BASE_URL is reachable from the host machine and that any required API keys or authentication methods are configured as needed by StatsWR.
• The DEFAULT_TIMEOUT value controls request timeouts to the StatsWR API; adjust as needed for slow networks.
• If you run into port conflicts, change the PORT value in the .env and ensure the hosting environment exposes that port.
• Keep the mcp_src/statsWR_mcp_server.py script compatible with your StatsWR API version; update if the API changes.
• On Windows, you may follow the Windows Setup steps in the README to create a virtual environment and activate it before running uv.