AI导哈

IPL数据分析服务器

一个自包含的MCP服务器，用于回答关于印度超级联赛（IPL）板球数据的自然语言问题。

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

使用说明

IPL MCP服务器

GitHub存储库（所有代码和IPL数据）：
https://github.com/MadhavKrishna09/ipl-mcp-server

🏏 项目概述

该项目是一个自包含的MCP（模型上下文协议）服务器，旨在回答有关印度超级联赛（IPL）板球数据的各种自然语言问题。

📦 回购内容

  • ipl_mcp_server.py –MCP服务器（主逻辑）
  • data_loader.py –将IPL JSON加载到SQLite中
  • schema.sql –数据库模式（关系型）
  • requirements.txt –Python包要求
  • ipl_data/ –**需要IPL JSON文件**
  • ipl_data.db –由加载器脚本（SQLite DB）创建
  • demo_queries.md –Claude Desktop的示例/测试查询
  • claude_desktop_config_template.json –克劳德集成配置
  • README.md –此文件

⚡️ 快速开始

  1. 克隆此存储库：

    git clone https://github.com/MadhavKrishna09/ipl-mcp-server.git
cd ipl-mcp-server

  2. 安装依赖项：

    pip3 install -r requirements.txt

  3. IPL数据目录
    这 ipl_data/ 文件夹 此存储库中的文件夹已包含IPL JSON文件，可供即时开箱使用！.
    无需下载或解压缩额外数据。

    想分析更多比赛吗？

    您可以简单地将新的IPL匹配JSON文件（例如，从cricsheet.org下载）添加到IPL_data/文件夹中，与现有文件放在一起。

  4. 将数据加载到SQLite数据库中：

    python3 data_loader.py

    您应该看到日志，表明匹配和交付已成功加载。

  5. 配置Claude Desktop以进行MCP集成：

    • 找到你的python路径：
      which python3
    • 编辑提供的 claude_desktop_config_template.json 使用您的python路径和项目文件夹。
    • 将此配置复制到您的Claude配置目录：
      • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
    • 配置示例：
      {
    "mcpServers": {
        "ipl-cricket-analyzer": {
            "command": "/your/python3/path",
            "args": ["/your/full/path/ipl_mcp_server.py"],
            "env": {"PYTHONUNBUFFERED": "1"}
        }
    }
}

  6. 重新启动克劳德桌面 （完全关闭并重新打开以使配置生效）。

📝 完整设置说明

先决条件

  • Python 3.8或更高版本（在3.13上测试）
  • Claude Desktop（最新版本，支持MCP）
  • git、pip和命令行环境

1.克隆和安装

git clone https://github.com/MadhavKrishna09/ipl-mcp-server.git
cd ipl-mcp-server
pip3 install -r requirements.txt

2.检查IPL数据目录

确保以下内容产生非零计数：

ls ipl_data/*.json | wc -l

如果是这样，你就准备好了。不需要进一步的数据操作。

3.加载数据库

python3 data_loader.py

4.MCP服务器和克劳德桌面设置

  • 使用提供的配置模板文件。
  • 确保所有路径都是绝对正确的。
  • 重新启动克劳德桌面。
  • 在Claude界面底部查找MCP服务器/工具指示器。

👩🔬 如何演示/验证

  • 使用来自的查询 demo_queries.md 在克劳德桌面聊天提示中。
  • 检查答案是否以可读的文本/表格形式返回，这些文本/表格是从IPL数据生成的。

🧩 故障排除

  • 服务器在Claude中未连接：
    仔细检查你的python路径， claude_desktop_config.json 而那个 ipl_data/ 存在。
  • 数据库错误：
    重新运行 python3 data_loader.py.
  • Claude中没有输出或错误：
    更改配置后重新启动Claude，检查日志。

**感谢您的审阅！**

相关 MCP