国际象棋数据服务

通过Model Context Protocol (MCP)服务器提供Chess.com的玩家数据和统计信息,适用于需要集成国际象棋数据的开发者和应用。

  • by Ramakrishna-Gedala
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Ramakrishna-Gedala/mcp-chess

使用说明

MCP象棋服务器

概述

此存储库提供了一个模型上下文协议(MCP)服务器,该服务器通过Anthropic的FastMCP框架公开Chess.com数据。该服务器在stdio上运行,可以在本地或直接从Claude Desktop启动。

能力

  • get_chess_player_profile:通过调用返回Chess.com用户名的公共配置文件 https://api.chess.com/pub/player/{username} 通过 requests.
  • get_chess_player_stats:从中检索评级历史和绩效指标 https://api.chess.com/pub/player/{username}/stats.

这两个工具都已注册 FastMCP('Chess.com') 在 chess.server 并且一旦服务器运行,任何MCP兼容客户端都可以使用。

先决条件

  • Python 3.13或更新版本
  • Git
  • 紫外线 用于依赖关系管理
  • Claude Desktop(或其他MCP客户端)

设置

1.克隆存储库

git clone <your-repo-url>
cd mcp-build-chess

2.在可编辑模式下安装依赖项

uv pip install -e .

提示:创建一个隔离的环境 uv venv .venv 并在安装前激活它。

3.在本地验证服务器

uv run python -m chess.server

服务器将启动并等待stdio。使用 Ctrl+C 一旦你确认它没有错误地启动,就停止它。

Claude桌面集成

更新 claude_desktop_config.json 因此Claude Desktop可以从该存储库启动服务器:

克劳德在当地的形象

{
  "mcpServers": {
    "Chess_Server": {
      "command": "uv",
      "args": [
        "--directory",
        "W:\\ITversity\\MCP Claude\\code\\mcp-build-chess\\src\\chess",
        "run",
        "chess"
      ]
    }
  }
}

##git仓库中的claude配置

{
  "mcpServers": {
    "Chess_Server_git": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/Ramakrishna-Gedala/mcp_chess.git@main",
        "chess-server"
      ]
    }
  }
}

更换 cwd 值与克隆存储库的绝对路径。macOS和Linux用户应该指定他们自己的路径语法(例如, /Users/you/src/mcp-build-chess).保存配置后,重新启动Claude Desktop以获取新的服务器配置。