baseball-mcp: An MLB Stats API Wrapper for MCP

baseball-mcp: An MLB Stats API Wrapper for MCP

site icon
2025.03.27 0
PythonMLB数据服务体育数据API娱乐功能
mcp_mlb_statsapi 是一个基于 MCP (Multi-Channel Pipeline) 框架的 MLB 数据 API 封装服务。它提供了对 MLB 数据的便捷访问和处理能力,包括赛程、比赛结果、球队信息等。该服务旨在在 MCP 框架内高效地检索和处理 MLB 数据。
View on GitHub

Overview

基本能力

产品定位

mcp_mlb_statsapi 是一个 MLB 数据 API 的封装服务,专为在 MCP 框架内高效检索和处理 MLB 数据而设计。

核心功能

  • 赛程查询: 检索指定日期范围内的 MLB 比赛赛程,可按球队筛选。
  • 比赛结果: 获取每日比赛结果,包括比分、胜负球队和胜投手信息。
  • 球队结果: 获取特定球队最近比赛的详细结果,包括得分情况和精彩瞬间。
  • 球员查询: 通过姓氏、名字或组合查询球员 ID,支持模糊匹配。

适用场景

  • MLB 数据分析和统计
  • 棒球比赛信息查询系统
  • 体育数据集成应用

工具列表

  • MLB-StatsAPI: 提供对 MLB 官方 API 的访问能力

常见问题解答

  • 安装问题: 确保 Python 3.10+ 和 uv 包管理器已正确安装
  • 集成问题: 确保正确配置 Claude for Desktop 的配置文件

使用教程

使用依赖

  1. 安装 Python 3.10 或更新版本
  2. 安装 uv 包管理器:
  3. Mac: bash brew install uv
  4. Windows: bash powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

安装教程

  1. 通过 PyPI 安装: bash pip install mcp_mlb_statsapi
  2. 或通过源码安装: bash uv venv source .venv/bin/activate uv pip install -r requirements.txt

调试方式

  1. 配置 Claude for Desktop 的配置文件 claude_desktop_config.json
  2. 根据安装方式选择相应配置:
  3. PyPI 安装: json { "mcpServers": { "mcp_mlb_statsapi": { "command": "{YOUR_PYTHON_EXECUTABLE_PATH}/python", "args": ["-m", "mcp_mlb_statsapi"] } } }
  4. 源码安装: json { "mcpServers": { "mcp_mlb_statsapi": { "command": "{YOUR_UV_EXECUTABLE_PATH}/uv", "args": [ "--directory", "{YOUR_PROJECT_PATH}/src/mcp_mlb_statsapi", "run", "mcp_mlb_statsapi" ] } } }
  5. 启动服务后,可通过 MCP 框架调用相关功能

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。