使用说明
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以获取新的服务器配置。