AI导哈

国际象棋分析服务器

一个集成了Stockfish引擎和Lichess API的国际象棋分析服务器，无需命令行工具即可部署，适用于个人棋局分析和最佳走法计算。

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

使用说明

国际象棋MCP服务器

带有Stockfish和Lichess集成的国际象棋分析MCP服务器-无需任何命令行工具即可部署！

特性

  • Stockfish发动机集成 -深度位置分析和最佳移动计算
  • Liches API集成 -获取用户游戏、云评估和打开数据库
  • 基于Web的部署 -无需CLI，全部通过浏览器界面
  • Claude.ai集成 -直接连接到Claude Pro/Max/团队/企业
  • 免费主机 -在Google Cloud Run免费版上部署

MCP工具可用

部署后，Claude.ai可以使用这些工具：

  1. 分析位置 -基于评估分数和主要变量的深入分析
  2. get_best_move -计算任何位置的最佳移动
  3. validate_move -检查搬家是否合法
  4. get_legal_moves -列出某一职位的所有合法变动
  5. fetch_user_games -获取任何Lichess用户的最新游戏
  6. get_cloud_eval -访问Lichess主游戏数据库

部署指南-无需命令行！

本指南仅使用web浏览器，不需要终端，也不需要CLI工具。

您将使用什么

  • GitHub Web界面-在浏览器中创建文件
  • 谷歌云控制台-使用web UI部署
  • Claude.ai设置-用于连接的Web界面

所需时间： 1-2小时 技术水平： 初学者友好

先决条件

您需要帐户（全部免费）：

  • []GitHub帐户-https://github.com/signup
  • []谷歌云帐户-https://console.cloud.google.com
  • []Lichess帐户-https://lichess.org/signup
  • []Claude.ai Pro/Max/团队/企业版-https://claude.ai

第1部分：获取Licess API代币

第一步：创建Lichess代币

  1. 首选https://lichess.org并登录
  2. 首选https://lichess.org/account/oauth/token
  3. 在...之下 “个人API访问令牌”，单击 “新令牌”
  4. 填写：
    • 令牌描述： Chess MCP Server
    • 范围： 勾选这些框：
      • ✅ 读取首选项
      • ✅ 阅读游戏
  5. 点击 “创建”
  6. 复制令牌 -下一步你需要它
    • ⚠️ 把它保存在安全的地方！你不会再看到它了。

第二部分：设置谷歌云

步骤2.1：创建谷歌云项目

  1. 首选https://console.cloud.google.com
  2. 使用您的Google帐户登录
  3. 点击项目下拉菜单（左上角显示“选择项目”）
  4. 点击 “新项目”
  5. 填写：
    • 项目名称： chess-mcp-server
    • 地点： 保留默认值
  6. 点击 “创建”
  7. 等待30秒，然后从下拉列表中选择新项目

步骤2.2：启用计费（免费套餐需要）

  1. 在左侧菜单中，单击 “账单” 或前往https://console.cloud.google.com/billing
  2. 点击 “链接账单帐户” 或 “创建账单帐户”
  3. 按照步骤添加付款方式
    • ✅ 有 $300免费积分
    • ✅ 如果您住在免费层，则不会收费
    • ✅ 可以设置账单提醒

步骤2.3：启用所需的API

  1. 首选 API和服务 → 图书馆 或https://console.cloud.google.com/apis/library
  2. 搜索并启用其中的每一个（单击它们，然后单击 “启用”):
    • 云运行API
    • 云构建API
    • 工件注册表API
    • 密钥管理器API

每个需要10-30秒才能启用。

步骤2.4：为Lichess令牌创建秘密

  1. 首选 秘密经理 在左侧菜单或https://console.cloud.google.com/security/secret-manager
  2. 点击 “创建秘密”
  3. 填写：
    • 姓名： lichess-token
    • 机密值： 从步骤1粘贴Licess API令牌
  4. 点击 “创建秘密”

第3部分：部署到云运行

步骤3.1：打开云运行

  1. 首选 云运行 在左侧菜单或https://console.cloud.google.com/run
  2. 点击 “创建服务”

步骤3.2：配置部署

填写表格：

集装箱部分：

  1. 选择 “从存储库（基于源代码）持续部署”
  2. 点击 “使用云构建进行设置”
  3. 在弹出窗口中：
    • 存储库提供者： 选择 “GitHub”
    • 点击 “验证” 并授权Google Cloud访问GitHub
    • 存储库： 选择您的 chess-mcp-server 存储库（或您的分支）
    • 分行： ^main$ （或 ^master$ 取决于您的默认分支）
    • 构建类型： “Dockerfile”
    • 点击 “保存”

服务设置：

  • 服务名称： chess-mcp-server
  • 地区： 选择一个离你近的（例如。， us-central1)
  • CPU分配： 选择 “CPU仅在请求处理期间分配”

身份验证：

  • 选择 “允许未经身份验证的调用” （目前-稍后可以保证）

容器设置 （点击“容器、网络、安全”）：

  • 集装箱港口： 8080
  • 内存： 2 GiB
  • CPU： 2
  • 每个容器的最大请求数： 10
  • 超时： 60 秒
  • 最小实例数： 0
  • 最大实例数： 5

环境变量 （在“变量和秘密”选项卡中）：

  1. 点击 “添加变量”
    • 姓名： STOCKFISH_PATH
    • 价值： /usr/games/stockfish
  2. 点击 “添加变量”
    • 姓名： STOCKFISH_DEPTH
    • 价值： 18

秘密 （在同一个“变量和秘密”选项卡中）：

  1. 点击 “引用秘密”
    • 秘密： 选择 lichess-token
    • 版本： latest
    • 暴露为环境变量： ✅
    • 姓名： LICHESS_TOKEN

步骤3.3：部署！

  1. 点击 “创建” 在底部
  2. 等待3-5分钟进行部署
    • 您将看到一个建筑动画
    • 可以点击 “日志” 观察进展

当你看到✅ 绿色对勾，完成！

步骤3.4：获取您的服务URL

  1. 您将在顶部看到您的服务URL，例如：
    https://chess-mcp-server-abc123xyz-uc.a.run.app
  2. 复制此URL -你需要它来给Claude.ai

第4部分：连接到第ai条

步骤4.1：添加自定义连接器

  1. 首选https://claude.ai
  2. 使用您的Pro/Max/Team/Enterprise帐户登录
  3. 点击 设置 （左下角的齿轮图标）
  4. 点击 集成 标签
  5. 滚动到 “自定义连接器” 章节
  6. 点击 “添加连接器” 或 "+" 按钮

步骤4.2：配置连接器

填写表格：

  • 显示名称： Chess Analysis
  • 说明（可选）： Analyze chess games with Stockfish and Lichess
  • 服务器URL: https://your-cloud-run-url.run.app/mcp
    • ⚠️ 重要提示： 添加 /mcp 最后！
    • 例子： https://chess-mcp-server-abc123-uc.a.run.app/mcp
  • API密钥（可选）： 暂时留空

步骤4.3：保存并启用

  1. 点击 “添加” 或 “保存”
  2. 在列表中找到您的连接器
  3. 快捷开关 开 （应变为蓝色/活动）

第五部分：与克劳德一起测试！

尝试以下命令：

测试1：分析一个职位

Analyze this chess position:
rnbqkbnr/pppppppp/8/8/4P3/8/PPPP1PPP/RNBQKBNR b KQkq e3 0 1

What should Black play?

测试2：获得最佳动作

What's the best move for White in this position?
FEN: r1bqkb1r/pppp1ppp/2n2n2/4p3/2B1P3/5N2/PPPP1PPP/RNBQK2R w KQkq - 4 4

测试3：获取巫妖游戏

Show me the last 5 games from Lichess user "DrNykterstein"

如果克劳德用你的工具回应并给你下棋分析， 它正在工作！

故障排除

问题：“部署失败”

  • 首选 云构建 → 历史 在谷歌云控制台中
  • 点击失败的构建并读取错误日志

问题：“克劳德无法连接”

  • 验证您的URL是否以结尾 /mcp
  • 检查连接器是否启用（打开）
  • 确保你有克劳德Pro/Max/团队/企业

问题：“未找到Stockfish”

  • 检查一下 STOCKFISH_PATH 环境变量设置为 /usr/games/stockfish
  • 查看云运行日志中的错误

成本信息

每月费用： 0美元（通常使用免费套餐）

Google Cloud Run免费版包括：

  • 每月200万次请求
  • 360000 GB秒的内存
  • 180000 vCPU秒

这足以用于个人象棋分析。

许可证

此项目根据GNU通用公共许可证v3.0获得许可-请参阅 许可证 文件以获取详细信息。

技术细节

  • 语言： Python 3.11
  • 框架： FastMCP（模型上下文协议）
  • 象棋引擎： 长筒鱼
  • 国际象棋图书馆： python象棋
  • HTTP客户端： httpx
  • 集装箱： Docker在云端运行

贡献

欢迎投稿！请随时提交拉取请求。

支持

对于问题或疑问：

  1. 检查上面的故障排除部分
  2. 在谷歌云控制台中查看云运行日志
  3. 在GitHub上打开一个问题

您现在有一个与Claude.ai集成的实时国际象棋分析服务器！

相关 MCP