Cricket Mcp Server

Cricket MCP Server

一个 Model Context Protocol（MCP）服务，可提供来自 Cricbuzz 的全面板球数据。此服务提供实时板球统计数据、球员信息、比赛日程和新闻更新。

功能

• 球员统计数据：获取详细的板球球员统计数据，包括所有赛制（Test、ODI、T20）中的击球和投球记录
• 正在进行的比赛：获取当前正在进行的板球比赛
• 比赛日程：获取即将举行的板球比赛日程
• 板球新闻：最新板球新闻和动态
• ICC 排名：Test、ODI 和 T20 赛制中击球、投球、全能球员和球队的官方 ICC 排名
• 比赛记分卡：包含击球和投球统计数据的详细比赛分析
• 实时解说：获取指定比赛 URL 的最新逐球动态
• 网络搜索：搜索互联网中的板球主题内容，并获取标题和摘要

安装

1. 克隆或下载此仓库
2. 安装所需依赖项：

pip install -r requirements.txt

演示：Gradio 网页界面

你可以通过由 Gradio 和 Gemini 提供支持的对话式网页界面与 Cricket MCP Server 交互。

1. 设置 Gemini API 密钥

你需要 Google Gemini API 密钥才能使用对话式 Agent。将其设为环境变量：

export GOOGLE_API_KEY="your-gemini-api-key"

2. 运行 Gradio 演示

python3 cricket_gradio.py

这将在浏览器中启动网页界面，你可以与板球助手聊天，询问统计数据、正在进行的比赛、新闻等。

提示： 聊天界面支持对话记忆和丰富的回复。

使用方法

作为 MCP 服务运行

此服务可与 MCP 客户端集成。配置方法如下：

    {
        "cricket": {
            "command": "python3",
            "args": ["cricket_server.py"],
            "transport": "stdio",
        }
    }

如需更灵活的设置，可以使用环境变量指定 python 可执行文件和服务脚本路径。

独立运行

如需测试，可以直接运行此服务：

python3 cricket_server.py

可用工具

1. get_player_stats

获取全面的板球球员统计数据。

参数：

• player_name（str）：板球球员姓名
• match_format（str，可选）：指定赛制（"Test"、"ODI"、"T20"）。如果未提供，则返回所有赛制的数据。

返回：

• 球员基本信息（姓名、国家、角色、图片）
• 击球和投球的 ICC 排名
• 详细的击球统计数据
• 详细的投球统计数据

示例：

# Get all stats for a player
stats = get_player_stats("Virat Kohli")

# Get only T20 stats
t20_stats = get_player_stats("Virat Kohli", "T20")

2. get_live_matches

获取当前正在进行的板球比赛。

返回： 正在进行的比赛信息列表，包括球队和当前状态。

3. get_cricket_schedule

获取即将举行的板球比赛日程。

返回： 即将举行的国际板球比赛列表，包括日期和详情。

4. get_cricket_news

获取最新板球新闻。

返回： 板球新闻文章列表，包括标题、描述、时间戳和类别。

5. get_icc_rankings

获取各类别的官方 ICC 板球排名。

参数：

• category（str）：排名类别。必须为以下之一："batting"、"bowling"、"all-rounder" 或 "teams"。

返回： 包含 Test、ODI 和 T20 赛制排名的字典。每种赛制都包含球员或球队列表，以及其排名、姓名、国家和评分。

示例：

# Get batting rankings
batting_rankings = get_icc_rankings("batting")

# Get bowling rankings
bowling_rankings = get_icc_rankings("bowling")

# Get team rankings
team_rankings = get_icc_rankings("teams")

6. get_match_details

获取指定板球比赛的详细记分卡。

参数：

• match_url（str）：Cricbuzz 上比赛的 URL（可通过 get_live_matches 获取）。

返回： 包含比赛详情的字典，包括比赛标题、结果，以及每局详细的记分卡和击球、投球统计数据。

7. get_live_commentary

获取指定板球比赛的最新实时解说。

参数：

• match_url（str）：Cricbuzz 比赛页面 URL（比赛通用页面或直接解说标签页）
• limit（int，可选）：要返回的最新条目数上限（默认值为 20）

返回： 包含 title、commentary_url 和 events（解说文本列表）的字典。

示例：

commentary = get_live_commentary("https://www.cricbuzz.com/live-cricket-scorecard/12345")

8. web_search

搜索网页并返回包含标题和摘要的结果。

参数：

• query (str)：搜索查询
• num_results (str, optional)：结果数量（默认值为 5）
• site_filter (str, optional)：限制搜索范围，例如 cricbuzz.com

返回： 结果列表：{ "title": str, "url": str, "snippet": str }。

9. search_live_commentary

在网上搜索板球比赛的实时解说和动态。

参数：

• match_description (str, optional)：完整的比赛描述（例如，“Zimbabwe vs New Zealand 2nd Test”）
• team1 (str, optional)：第一支球队的名称
• team2 (str, optional)：第二支球队的名称

返回： 来自板球新闻网站、包含实时解说和比赛动态的网页搜索结果列表。

示例：

# Search by match description
results = search_live_commentary(match_description="Zimbabwe vs New Zealand 2nd Test")

# Search by team names
results = search_live_commentary(team1="Zimbabwe", team2="New Zealand")

数据源

此服务会从 Cricbuzz.com 抓取数据，并使用 Google Search 查找球员资料。请确保遵守网站的服务条款并负责任地使用。

依赖项

• fastmcp：MCP 服务框架
• requests：用于网页抓取的 HTTP 库
• beautifulsoup4：HTML 解析库
• lxml：XML/HTML 解析器
• googlesearch-python：Google 搜索 API 封装库

配置

此服务默认使用 stdio 传输。基本用法无需额外配置。

错误处理

此服务包含完善的错误处理机制，适用于以下情况：

• 网络连接问题
• 无效的球员姓名
• Cricbuzz 上缺少数据
• 搜索失败

MCP 目录徽章

将此徽章添加到 README，以表明你的服务已收录且安全：

许可证

此项目采用 MIT 许可证。详情请参阅 LICENSE 文件。

贡献

欢迎提交问题和改进建议！

免责声明

此工具会抓取公共网站的数据。作者不对任何滥用行为或违反网站服务条款的行为负责。请负责任地使用，并确保遵守适用的条款和条件。