MCP Servers

A collection of Model Context Protocol servers, templates, tools and more.

X
Xiangqi MCP Server

中国象棋mcp server

Created 4/22/2026
Updated about 4 hours ago
Repository documentation and setup instructions

♟️ 基于 MCP 协议与多模型协同的中国象棋智能对弈系统

!!!!要下载文件Pikafish中的pikafish.exe和pikafish.nnue文件!!!! 一.如何运行 1.终端运行node server.js 2.新开一个终端运行python mcp_server.py 3.打开登录页登录注册或直接登录账号:账号:1 密码:123 http://localhost:3000/login.html

4.打开cherry stdio在mcp服务器和api服务器正常情况下通过自然语言指挥对弈或在象棋界面中拖拽走子

二.项目简单解释 1.象棋棋盘调用xiangqi_board(见文件);象棋规则调用xiangqi_rule(见文件);算力引擎为Pikafish

2.cherry stdio模型提示词为 你是一个中国象棋AI助手,通过MCP工具与棋盘交互。用户输入调用工具你就必须调用工具 【Few-shot示例】 用户:帮我走炮二平五 正确做法: Step1: 调用 get_board_state Step2: 调用 analyze_position 确认炮的位置 Step3: 调用 make_move {"from": "h9", "to": "e9"} 错误做法:直接回答"好的,炮二平五已执行"(未调用任何工具)

【坐标系铁律 - 违反必出错】 FEN坐标列字母与中文路数方向完全相反: a列 = 九路(棋盘最左) b列 = 八路 c列 = 七路 d列 = 六路 e列 = 五路(中路) f列 = 四路 g列 = 三路 h列 = 二路 i列 = 一路(棋盘最右)

行数字:0=黑方底线,9=红方底线(红帅在行9)

【走子前必须执行的流程】

  1. 先调用 get_board_state 获取当前FEN
  2. 再调用 analyze_position 确认目标棋子的精确坐标
  3. 换算坐标(中文路数→FEN列字母,注意方向相反)
  4. 最后调用 make_move 执行

【禁止行为】

  • 禁止凭记忆猜测棋子位置,每次走子前必须查询
  • 禁止把列字母直接当路数(a≠一路)
  • 禁止跳过 analyze_position 直接走子
Quick Setup
Installation guide for this server

Install Package (if required)

uvx xiangqi_mcp_server

Cursor configuration (mcp.json)

{ "mcpServers": { "aaaaaaa233-xiangqi-mcp-server": { "command": "uvx", "args": [ "xiangqi_mcp_server" ] } } }