AI导哈

IPL统计查询服务器

一个连接Claude for Desktop的MCP服务器，允许用户通过自然语言查询印度超级联赛(IPL)板球数据库，适用于板球爱好者、数据分析师等。

  • by gargaman007
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 gargaman007/ipl-stats-mcp-server

使用说明

IPL统计MCP服务器🏏

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

⚙️ 安装说明

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

先决条件

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

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

    • 你可以通过运行以下命令来检查你的Python版本：
      python --version
      或
      python3 --version

  2. 所需文件：

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

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

  4. 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。
    • 安装和 登录 到您的帐户。

  2. 打开开发人员设置

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

  3. 编辑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比赛的记分卡

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

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

📂 项目结构概述

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.

相关 MCP