AI导哈

国际象棋服务器构建工具

一个用于构建交互式AI驱动的国际象棋游戏服务器的工具，支持棋局状态管理、AI对战和拖放式交互界面。

  • by idosal-mndy
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 idosal-mndy/mcp-workshop

使用说明

MCP工作坊：构建国际象棋服务器

从头开始构建模型上下文协议（MCP）服务器的实践研讨会。学习如何通过构建一个具有漂亮UI的完整象棋游戏服务器来创建交互式AI驱动的应用程序。

分叉自https://github.com/ibuildthecloud/chess-mcp

🎯 你将建造什么

在本次研讨会结束时，您将创建一个功能齐全的国际象棋MCP服务器，该服务器：

  • 接受代数记数法中的国际象棋棋步
  • 在会话间保持游戏状态
  • 通过拖放显示交互式棋盘
  • 允许AI代理与用户下棋

🚀 入门指南

所有车间材料均在 workshop/ 目录。从综合指南开始：

📖 打开《车间指南》→

📋 先决条件

  • Node.js 20+ 安装
  • 纳米机器人 用于测试： brew install nanobot-ai/tap/nanobot 或 在这里下载
  • OpenAI API密钥：将API密钥设置为环境变量：
    export OPENAI_API_KEY=sk-...
  • TypeScript基础知识
  • 文本编辑器或IDE
  • 终端/命令行访问

📚 厂房结构

研讨会分为5个渐进步骤：

  1. 步骤1：基本MCP服务器设置

    • MCP服务器基础
    • 工具注册
    • HTTP传输中间件

  2. 步骤2：添加国际象棋功能

    • 集成chess.js库
    • 国际象棋移动验证
    • 董事会国家代表

  3. 步骤3：国家管理

    • 基于会话的持久性
    • 文件系统存储
    • 加载和保存游戏

  4. 步骤4：基本UI组件

    • MCP UI资源
    • 响应中的HTML内容
    • 多种内容类型

  5. 步骤5：互动棋盘

    • 使用棋盘.js的高级用户界面
    • 拖放功能
    • 双向通信

每个步骤都是一个独立的项目，有自己的 package.json 以及源文件。

🎓 学习成果

完成本次研讨会后，您将了解：

  • ✅ 如何使用HTTP传输构建MCP服务器
  • ✅ 工具注册和输入验证
  • ✅ 状态会话管理
  • ✅ 使用MCP-UI的交互式UI组件
  • ✅ UI和工具之间的双向通信
  • ✅ MCP服务器开发的最佳实践

🛠️ 技术栈

📖 其他资源

💡 研讨会后的后续步骤

通过以下方式增强您的国际象棋MCP服务器：

  • 多游戏支持
  • PGN进口/出口
  • 移动历史记录并撤消
  • 职位分析
  • 时间控制
  • 多玩家支持

📄 许可证

Apache 2.0许可证-请参阅 许可证 文件以获取详细信息。

准备好开始了吗？ 前往 工作坊指南 开始建造！

相关 MCP