Cric

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

1. 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
   

2. Configure Environment Variables: Create a .env file based on .env.example:

   cp .env.example .env
   

   Add your Neon PostgreSQL URL and Redis URL.

3. Run Database Migrations:

   alembic upgrade head
   

4. Run the Application:

   uvicorn app.main:app --reload
   

Connecting 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.

1. Connect your GitHub repository to Render.
2. Render will automatically detect the render.yaml file.
3. It will provision a Redis instance and the web service.
4. Make sure to set the DATABASE_URL environment variable securely in the Render dashboard for your Neon Postgres connection.