使用说明

项目简介

Soccerdata MCP Server 是一个开源的 MCP 服务器，它连接到 SoccerDataAPI，通过自然语言交互为用户提供最新的足球比赛信息。该服务器专为 MCP 客户端（如 Claude Desktop）设计，允许用户通过大型语言模型（LLM）检索足球数据。

主要功能点

实时足球比赛信息: 专注于提供全球正在进行的足球比赛的实时信息。
全面的比赛数据: 提供包括比赛列表、基本信息、比赛详情、关键事件、球队阵容、赔率和联赛元数据等详细的足球数据。
支持多种比赛状态: 涵盖正在直播、即将开始和最近结束的比赛信息。
易于集成: 通过简单的配置即可集成到支持 MCP 协议的客户端，如 Claude Desktop。

安装步骤

克隆仓库:

git clone https://github.com/yeonupark/mcp-soccer-data.git
cd mcp-soccer-data

安装依赖: 确保已安装 Python 3.12+ 和 'uv' 包管理器。然后运行：
```
uv sync
```
配置 API 密钥:
- 在仓库根目录下创建 '.env' 文件。
- 访问 https://soccerdataapi.com/ 注册并获取 API 密钥。
- 将 API 密钥添加到 '.env' 文件中，例如：
```
AUTH_KEY=your_auth_key
```

服务器配置

要将 Soccerdata MCP Server 集成到 MCP 客户端（例如 Claude for Desktop），您需要配置客户端的 MCP 服务器设置。以下是 Claude for Desktop 的配置示例，您需要根据您的实际路径进行调整。

Claude for Desktop 配置 ( '~/Library/Application Support/Claude/claude_desktop_config.json' )

{
  "mcpServers": {
      "mcp-soccer-data": {  // 服务器名称，可以自定义
          "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv", // uv 包管理器的绝对路径
          "args": [
              "--directory",  // 指定工作目录为项目 src 目录
              "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src/", // 项目 src 目录的绝对路径
              "run",          // 运行命令
              "--env-file",   // 指定环境变量文件路径
              "/ABSOLUTE/PATH/TO/PARENT/FOLDER/.env", // .env 文件的绝对路径
              "server.py"     // 服务器启动脚本
          ]
      }
  }
}

请注意:

将 '/ABSOLUTE/PATH/TO/PARENT/FOLDER' 替换为您的 'mcp-soccer-data' 仓库父目录的绝对路径。
确保 'uv' 包管理器已安装并在您的 'PATH' 环境变量中，或者提供 'uv' 的绝对路径。

基本使用方法

启动 MCP 客户端（例如配置好 Soccerdata MCP Server 的 Claude Desktop）。
在客户端中，您可以使用自然语言提问有关足球比赛的问题，例如：
- "现在有哪些足球比赛正在进行？"
- "今天巴黎圣日耳曼对阵阿斯顿维拉的预测阵容是什么？"
- "请告诉我最近足球比赛的比分和进球数。"
Soccerdata MCP Server 将会处理您的请求，从 SoccerDataAPI 获取数据，并通过 MCP 协议返回给客户端，客户端会以自然语言或结构化形式呈现足球数据。

关键词