使用说明

项目简介

MCP Chess 是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在扩展 Claude AI 助手的国际象棋能力。通过这个服务器,Claude 可以理解和执行与国际象棋相关的指令,例如展示棋盘状态、建议走法和验证棋步的合法性。

主要功能点

  • 生成棋盘图像: 根据国际象棋的 Forsyth-Edwards Notation (FEN) 字符串生成可视化的棋盘图像,方便用户直观地了解棋局。
  • 建议下一步棋: 利用 Stockfish 引擎,根据当前的棋盘状态为用户提供最佳的下一步棋建议,帮助用户提升棋艺。
  • 检查走法是否合法: 验证用户输入的棋步在当前棋局中是否符合国际象棋规则,确保游戏的顺利进行。

安装步骤

  1. 下载二进制文件: 访问 Releases 页面,根据你的操作系统下载对应的最新版本二进制文件('mcp-chess-windows.exe'、'mcp-chess-darwin' 或 'mcp-chess-linux')。
  2. 添加执行权限 (macOS/Linux): 如果你的操作系统是 macOS 或 Linux,打开终端,导航到下载目录,并运行以下命令为下载的文件添加执行权限:
    chmod +x mcp-chess-darwin   # for macOS
    chmod +x mcp-chess-linux    # for Linux
  3. 绕过 macOS 安全警告 (macOS): 首次在 macOS 上运行时,系统可能会出现安全警告。请按照仓库 README.md 文件中 “Bypassing Security Warnings” 部分的指引操作,以允许程序运行。
  4. 配置 Claude Desktop: 为了让 Claude AI 助手能够使用 MCP Chess 服务器,你需要配置 Claude Desktop 应用程序:
    • 打开 Claude Desktop 应用程序。
    • 点击菜单中的 “Settings” (设置),然后选择 “Developer” (开发者) 选项卡。
    • 在 “Developer” 选项卡中,点击 “Edit Config” (编辑配置) 按钮。
    • 这将打开一个配置文件。在 'mcpServers' 字段中添加以下 JSON 配置信息,用于注册 MCP Chess 服务器。
    • 保存修改后的配置文件,并重启 Claude Desktop 应用程序。

服务器配置

在 Claude Desktop 的配置文件 ('config.json') 中,'mcpServers' 字段用于配置 MCP 服务器。你需要添加类似以下的配置到该文件中。请注意将 'command' 的值替换为你下载的 'mcp-chess' 可执行文件的实际路径。

{
  "mcpServers": {
    "mcp-chess": {
      "command": "/path/to/mcp-chess-binary" // 将 "/path/to/mcp-chess-binary" 替换为 mcp-chess 可执行文件的绝对路径
    }
  }
}

注意: 'command' 字段的值必须是 'mcp-chess-windows.exe' (Windows), 'mcp-chess-darwin' (macOS) 或 'mcp-chess-linux' (Linux) 可执行文件的完整路径。请根据你文件存放的实际位置进行修改。

基本使用方法

完成上述配置后,你就可以在 Claude AI 中通过自然语言指令来使用 MCP Chess 服务器提供的国际象棋功能了。以下是一些使用示例:

  • 向 Claude 提问 “Show me the starting position of a chess game.” (展示国际象棋的初始局面) ,Claude 应该能够调用 MCP Chess 服务器生成并展示初始棋盘。
  • 你可以要求 Claude “Let's play a chess game. Check that each move is legal. Suggest the best move to play.” (我们来下国际象棋吧。请检查每一步是否合法,并建议最佳走法。),与 Claude 进行交互式国际象棋对弈。
  • 通过提问 “Is Nf3 a legal move from the starting position?” (从初始局面来看,Nf3 是一步合法的棋吗?) 来验证特定走法在当前局面下的合法性。
  • 当你想知道在特定棋局下如何走棋时,可以提问类似 “What's a good move for white in this position: "rnbqkbnr/pppp1ppp/8/4p3/4P3/8/PPPP1PPP/RNBQKBNR w KQkq - 0 2"?” (在 "rnbqkbnr/pppp1ppp/8/4p3/4P3/8/PPPP1PPP/RNBQKBNR w KQkq - 0 2" 这个局面中,白方有什么好的走法?) 这样的问题, Claude 将会调用 MCP Chess 服务器并给出建议。

信息

分类

AI与计算