Chess Mcp

Chess Mcp

🚀 国际象棋网MCP服务器

国际象棋网MCP服务器是一个为国际象棋网(Chess.com)发布数据API提供的模型上下文协议(MCP)服务器。借助标准化的MCP接口,该服务器能够访问国际象棋网的玩家数据、游戏记录及其他公开信息,方便AI助手搜索和分析国际象棋相关信息。

链接

✨ 主要特性

  • [x] 可访问玩家个人资料、统计信息和游戏记录
  • [x] 支持按日期和玩家搜索游戏
  • [x] 能够检查玩家在线状态
  • [x] 可获取俱乐部和头衔玩家的信息
  • [x] 无需身份验证(使用国际象棋网的公共API)
  • [x] 支持Docker容器化
  • [x] 提供交互式工具,供AI助手使用

工具列表是可配置的,您可以选择要提供给MCP客户端的工具。

🚀 快速开始

📦 安装指南

Docker(推荐)

使用Claude Desktop运行chess-mcp的最简单方法是通过Docker。如果您没有安装Docker,请从 Docker 官方网站 下载并安装。

编辑您的Claude Desktop配置文件:

  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

然后添加以下配置:

{
"mcpServers": {
"chess": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"pab1it0/chess-mcp"
]
}
}
}

直接使用UV

或者,您可以直接使用UV运行服务器。编辑您的Claude Desktop配置文件(位置如上所述),并添加以下服务器配置:

{
"mcpServers": {
"chess": {
"command": "uv",
"args": [
"--directory",
"",
"run",
"src/chess_mcp/main.py"
]
}
}
}

⚠️ 重要提示

如果在 Claude Desktop 中看到 Error: spawn uv ENOENT,您可能需要指定UV的完整路径或在配置中设置环境变量 NO_UV=1

💻 使用示例

以下是MCP服务器支持的工具列表及简单说明:

  • get_player_profile: 获取玩家个人资料信息。
  • search_games_by_date: 按日期搜索游戏记录。
  • check_online_status: 检查玩家在线状态。
  • get_club_info: 获取俱乐部详细信息。
  • retrieve_titled_players: 获取具有特定头衔的玩家列表。

每个工具都有详细的文档和示例,帮助您轻松集成到项目中。

🔧 技术细节

开发

欢迎贡献!如果您有任何建议或改进,请打开问题或提交拉取请求。

该项目使用 uv 管理依赖项。按照平台说明安装 uv

curl -LsSf https://astral.sh/uv/install.sh | sh

然后创建虚拟环境并安装依赖项:

uv venv
source .venv/bin/activate  # 在Unix/macOS上
.venv\Scripts\activate     # 在Windows上
uv pip install -e .

测试

该项目包含一个测试套件,确保功能并防止 regressions。

运行测试:

npm test
  • 0 关注
  • 0 收藏,7 浏览
  • system 提出于 2025-09-21 01:21

相似服务问题