国际象棋网MCP服务器是一个为国际象棋网(Chess.com)发布数据API提供的模型上下文协议(MCP)服务器。借助标准化的MCP接口,该服务器能够访问国际象棋网的玩家数据、游戏记录及其他公开信息,方便AI助手搜索和分析国际象棋相关信息。
工具列表是可配置的,您可以选择要提供给MCP客户端的工具。
使用Claude Desktop运行chess-mcp
的最简单方法是通过Docker。如果您没有安装Docker,请从 Docker 官方网站 下载并安装。
编辑您的Claude Desktop配置文件:
~/Library/Application Support/Claude/claude_desktop_config.json
%APPDATA%/Claude/claude_desktop_config.json
~/.config/Claude/claude_desktop_config.json
然后添加以下配置:
{
"mcpServers": {
"chess": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"pab1it0/chess-mcp"
]
}
}
}
或者,您可以直接使用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