Ipl Stats MCP Server

IPL统计MCP服务器🏏

该项目提供了一个 MCP（模型上下文协议）服务器 连接到 Claude桌面版，使您能够提问 自然语言问题 关于A 印度超级联赛（IPL） 板球数据库。\ 无论你是板球爱好者、统计分析师，还是只是对IPL历史感兴趣，这种设置都可以让Claude成为一个强大的统计查询工具。

______________________________________________________________________

⚙️ 安装说明

请仔细遵循以下步骤，使服务器在您的本地计算机上运行。

______________________________________________________________________

先决条件

在开始之前，请确保您拥有以下内容：

1. Python 3.10或更高版本 安装在您的机器上。

- 你可以通过运行以下命令来检查你的Python版本：

     python --version

或

     python3 --version

1. 所需文件：

- data_loader.py → 一个处理原始IPL JSON数据（存储在 data/ 文件夹）并生成 ipl.db SQLite数据库。 - 此脚本使用 SQL炼金术 定义数据库模式并将比赛数据加载到结构化表中（球队、球员、比赛、投中、交付）。 - 运行时，它将： 1. 删除任何现有 ipl.db 文件。 1. 创建所有必要的数据库表。 1. 从JSON文件加载比赛信息、球员详细信息、球队详细信息、局数和交付。 1. 将所有数据提交到数据库。 - 您可以使用以下命令运行它：

       python data_loader.py

确保 data/ 文件夹存在，在运行之前包含IPL JSON匹配文件。 - ipl.db → 包含IPL数据的SQLite数据库文件（可以通过运行以下命令生成 data_loader.py). - main.py → MCP服务器脚本。

1. 工作装置 Claude桌面版 （稍后提供说明）。

1. Google Gemini API密钥 --AI驱动的SQL查询生成所需。

- 从以下地址获取 谷歌人工智能工作室 - 在……里面 main.py，替换行中的占位符API键：

     genai.configure(api_key="YOUR_API_KEY_HERE")

______________________________________________________________________

步骤1：安装 uv （快速Python包安装程序）

我们将使用 紫外线 以实现高效的依赖关系管理。

Windows（PowerShell）:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

macOS/Linux（Bash）:

curl -LsSf https://astral.sh/uv/install.sh | sh

注： 安装后， 重新启动终端 以确保 uv 命令被识别。

______________________________________________________________________

步骤2：创建项目环境

1. 创建一个新的项目目录并导航到其中：

uv init topmate
cd topmate

2. 创建并激活虚拟环境：

• Windows（PowerShell）:

uv venv
.venv\Scripts\activate

• macOS/Linux（Bash）:

uv venv
source .venv/bin/activate

虚拟环境确保依赖关系在本地安装，不会干扰其他项目。

______________________________________________________________________

步骤3：安装依赖项

在虚拟环境处于活动状态时，安装所需的软件包：

uv add "mcp[cli]" "google-generativeai" pandas sqlalchemy httpx

包装说明：

• mcp[cli] → 核心MCP框架。
• google-generativeai → 启用AI集成（可选用例）。
• pandas → 用于强大的数据操作。
• sqlalchemy → 用于数据库查询。
• httpx → 用于发出HTTP请求。

______________________________________________________________________

步骤4：添加项目文件

复制ther ipl.db 和 main.py 文件进入 topmate 文件夹。\ 您的文件夹结构应该如下所示：

/topmate/
├── .venv/
├── ipl.db
└── main.py

______________________________________________________________________

🔌 连接到Claude for Desktop

1. 安装并登录

- 从Anthropic官方网站下载Claude for Desktop。 - 安装和 登录 到您的帐户。

1. 打开开发人员设置

- 点击您的 配置文件图标 （左下）→ 设置 → 开发者.

1. 编辑MCP配置

- 点击 编辑原始MCP配置. - 粘贴以下JSON（用实际文件夹路径替换路径）：

{
  "mcpServers": {
    "ipl_stats": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\ABSOLUTE\\PATH\\TO\\YOUR\\topmate",
        "run",
        "python",
        "main.py"
      ]
    }
  }
}

路径提示:

• 窗户：\

在您的终端中 topmate 文件夹，运行：

  cd

然后复制完整路径并替换反斜杠(\)双睫毛(\\).

• macOS/Linux：\

运行：

  pwd

并直接使用输出路径。

1. 保存并重新启动Claude

- 保存配置。 - 重新启动桌面版的Claude。

______________________________________________________________________

🚀 如何使用

一旦克劳德重新启动，你会注意到 “搜索和工具” 聊天输入栏旁边的图标。\ 现在，您可以用自然语言查询IPL统计数据。

查询和输出示例：

1. 给我看CSK和MI比赛的记分卡

Scorecard for CSK vs MI

1. 最成功的追逐目标是什么？

Most successful chase target

1. 哪个场馆的比赛得分最高？

Highest scoring venues

______________________________________________________________________

📂 项目结构概述

topmate/
│
├── .venv/                # Virtual environment for dependencies
├── ipl.db                 # IPL database (SQLite)
└── main.py                # MCP server script

______________________________________________________________________

🛠 故障排除

• uv 未识别： 安装后重新启动终端 uv.
• Windows上的路径问题： 确保您使用 双睫毛 在MCP配置中。
• Claude未检测到MCP服务器： 验证 main.py 脚本运行时没有错误：

  python main.py

• Gemini API关键错误： 确保在中正确设置了API密钥 main.py.

______________________________________________________________________