Production-Ready Cricket Updates MCP Server
An enterprise-grade Model Context Protocol (MCP) Server for daily cricket updates, built with Python, FastAPI, and the official MCP Python SDK.
Features
- MCP Integration: Fully compatible with Claude Remote MCP Connector.
- FastAPI: High-performance async API with endpoints for health, metrics, and MCP SSE transport.
- Clean Architecture: Strong separation of concerns with domain-driven design principles.
- Background Sync: Uses APScheduler with Redis distributed locking for syncing cricket data.
- Persistence: Async SQLAlchemy with PostgreSQL (Neon DB).
- Caching: Efficient caching strategies using Redis.
Setup Instructions
- Clone the repository and install dependencies:
python -m venv venv
source venv/bin/activate # On Windows use `venv\Scripts\activate`
pip install -r requirements.txt- Configure Environment Variables:
Create a .env file based on .env.example: ``bash cp .env.example .env `` Add your Neon PostgreSQL URL and Redis URL.
- Run Database Migrations:
alembic upgrade head- Run the Application:
uvicorn app.main:app --reloadConnecting Claude
To connect this server to Claude via the MCP Remote Connector, you can provide the SSE endpoint URL (http://localhost:8000/api/v1/mcp/sse) in your Claude Desktop configuration or the relevant client configuration.
Example Claude Desktop Config
{
"mcpServers": {
"cricket": {
"command": "node",
"args": ["path/to/remote/mcp-client", "http://localhost:8000/api/v1/mcp/sse"]
}
}
}Note: Depending on the client, you may just need to point directly to the URL.
Deployment
The project is configured for deployment on Render.
- Connect your GitHub repository to Render.
- Render will automatically detect the
render.yamlfile. - It will provision a Redis instance and the web service.
- Make sure to set the
DATABASE_URLenvironment variable securely in the Render dashboard for your Neon Postgres connection.
