使用说明

项目简介

MCP国际象棋服务器是依据Model Context Protocol (MCP) 标准构建的应用后端。它专为与支持MCP协议的大型语言模型(LLM)客户端配合设计，允许LLM通过调用标准化工具来下棋、查询棋局状态和进行棋谱分析。

主要功能点

• 开始新游戏: 启动一局全新的国际象棋游戏，并将棋盘重置到初始状态。可以指定LLM扮演白方还是黑方。
• 获取棋盘图像: 提供当前棋盘状态的可视化PNG图像。棋盘的显示方向会根据LLM的角色（白方或黑方）自动调整。
• 查询当前轮次: 告知当前轮到哪一方（白方或黑方）行棋。
• 获取合法走法: 列出当前局面下所有允许的棋步列表，采用UCI记谱法。
• 执行棋步: 接受一个标准代数记谱法(SAN)的棋步，将其在服务器管理的棋盘上执行。返回执行后的结果，包括使用的走法（SAN和UCI）、新的棋盘FEN串以及游戏是否已结束。
• PGN棋谱查找: 在给定的PGN格式棋谱中，查找并定位第一个符合特定条件的局面（例如“某个棋子在某个格子上”），并返回该局面的可视化图像。

安装步骤

本服务器是一个Python包。通常，作为MCP客户端的用户不需要手动安装或运行服务器代码。你的MCP客户端或管理器会根据配置自动下载（如果需要）并启动服务器进程。

服务器配置

要使用此服务器，你需要将它添加到你的MCP客户端的配置中。配置信息通常以JSON格式存储，关键在于指定如何启动服务器进程。

你需要添加一个名为 'chess' 的服务器配置，其核心是启动命令。启动命令通常使用 'uvx' 工具来运行已安装的Python包。

配置示例（这通常由你的MCP客户端管理，你只需知道需要添加）：

{
  "mcpServers": {
    "chess": {
      "command": "uvx", // 用于运行Python包的命令
      "args": [
        "mcp-chess" // 要运行的MCP服务器包名称
      ],
      "description": "International Chess server for LLMs" // 可选的描述
      // 客户端可能还有其他配置项，如传输协议 (stdio, websocket 等)
    }
  }
}

简单来说，你需要在你的MCP客户端配置中添加一个服务器，指定它的启动命令是 'uvx mcp-chess'。

基本使用方法

该服务器主要通过LLM客户端或支持MCP协议的代理程序进行交互。

1. 通过你的MCP客户端启动并连接到MCP国际象棋服务器。
2. LLM客户端可以通过调用服务器提供的工具（如 'new_game', 'make_move', 'get_board_visualization' 等）来模拟下棋过程、查询游戏状态或分析棋局。
3. 服务器接收工具调用请求，执行相应的国际象棋逻辑，并通过JSON-RPC响应将结果返回给LLM客户端。
4. LLM根据收到的信息（如棋盘图像、合法走法、游戏结果）决定下一步行动或生成回复。