Chesscom Mxcp

国际象棋MXCP服务器

采用MXCP构建的企业级Chess.com MCP服务器，具有缓存、分析、审计跟踪和高级数据分析功能。

特性

🚀 Core Chess.com API集成

• 玩家工具：个人资料、统计数据、在线状态、当前游戏、游戏档案
• 游戏工具：每月游戏、带缓存的PGN下载
• 标题球员：按标题列出玩家（GM、IM、FM等）
• 俱乐部工具：俱乐部简介和会员名单

💎 企业功能（MXCP优势）

• 智能缓存：不同数据类型的可配置TTL
• 速率限制：遵守API限制的令牌桶算法
• 连接池：具有keepalive的高效HTTP客户端
• 重试逻辑：具有指数回退的自动重试
• 审计跟踪：跟踪所有API使用情况和查询
• 错误处理：优雅的降级和详细的错误消息

📊 高级分析（原版不可用）

• 评级趋势：分析玩家评分随时间的变化
• 博弈分析：按时间控制和颜色绘制输赢图案
• 开业统计：大多数比赛的开场白和成功率
• 活动模式：玩家最活跃的时候
• 热门玩家：跟踪热门玩家和粉丝增长
• SQL查询访问：直接SQL访问缓存数据以进行自定义分析

🔐 安全与治理

• 身份验证支持：OAuth集成就绪
• 审计日志：完成API呼叫跟踪
• 策略引擎：细粒度访问控制
• 类型安全：全面验证

安装

1. 安装依赖项：

pip install httpx

1. 初始化数据库：

mxcp run tool get_player_profile --param username=hikaru

这将自动创建必要的缓存表。

用法

启动服务器

mxcp serve

连接到克劳德桌面

这 server_config.json 生成于 mxcp init。将其添加到您的Claude Desktop配置中。

查询示例

问克劳德：

• “获取Magnus Carlsen的个人资料并分析他的评级趋势”
• “显示所有总经理及其最近的活动”
• “分析我的开场曲目”（在拿到比赛后）
• “比较玩家闪电战和快速战的胜率”
• “本周寻找热门国际象棋选手”

SQL分析

启用SQL工具后，您可以运行自定义查询：

• “显示我玩过西西里防御的所有缓存游戏”
• “我星期二和其他日子的表现如何？”
• “列出评分提高100分以上的所有玩家”

配置

编辑 mxcp-site.yml 调整：

• 缓存不同数据类型的TTL
• 速率限制参数
• 审核设置
• SQL工具权限

建筑

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│   Chess.com     │     │   MXCP Server    │     │   DuckDB Cache  │
│      API        │◄────│  - Rate Limiter  │────►│  - API Cache    │
│                 │     │  - Retry Logic   │     │  - Game Archive │
└─────────────────┘     │  - Type Safety   │     │  - Analytics    │
                        └──────────────────┘     └─────────────────┘
                                 │
                                 ▼
                        ┌──────────────────┐
                        │   LLM Client     │
                        │  (Claude, etc)   │
                        └──────────────────┘

高级功能

缓存策略

• 玩家配置文件：1小时TTL
• 玩家统计：30分钟TTL
• 当前游戏：5分钟TTL
• 游戏档案：24小时TTL（历史数据）
• 游戏玩家：7天TTL
• 个人游戏：永久缓存

分析表

• chess_api_cache：常规API响应缓存
• chess_games_cache：带PGN的个人游戏存储
• player_profile_views：跟踪配置文件访问模式
• rating_history：玩家评级随时间变化
• player_activity：游戏计数跟踪
• audit_log：完成API使用审核跟踪

发展

添加新工具

1. 在中创建Python实现 python/
2. 在中定义工具 tools/ 使用YAML
3. 如果适用，添加SQL分析
4. 如果需要，更新缓存表

测试

# Test a specific tool
mxcp run tool get_player_profile --param username=hikaru

# Validate all tools
mxcp validate

# Check for drift
mxcp drift check

为什么选择MXCP？

此实现展示了MXCP如何改进基本MCP服务器：

1. 演出：缓存将API调用减少90%+
2. 分析：SQL访问实现了仅使用API无法实现的复杂分析
3. 可靠性：重试逻辑和速率限制可防止失败
4. 可观测性：审计跟踪可以准确显示正在发生的事情
5. 可扩展性：无需接触核心代码即可轻松添加新的分析
6. 类型安全：验证可防止运行时错误
7. 生产就绪：从第一天起就为规模而建

许可证

麻省理工学院