mcpField
C
Clash Royale MCP Server

Clash Royale MCP Server

本地服务
chat-royale.com游戏娱乐231 周前更新
代码仓库访问官网

关于 Clash Royale MCP Server

Clash Royale MCP Server 为 Clash Royale 数据提供 MCP 工具，供聊天 Agent 查询玩家、部落、卡牌和排名信息。它是 Chat Royale 数据查询架构的一部分，后端将 MCP 工具接入 Gemini。

主要功能

  1. 01查询玩家与部落数据
  2. 02获取卡牌信息
  3. 03查询游戏排名
  4. 04通过 Gemini 调用工具

适用场景

  1. 01查询玩家或部落资料
  2. 02了解卡牌相关信息
  3. 03检索游戏排名

MCP 相关

MCP 服务通过 Clash Royale API 向 MCP 客户端提供玩家、部落、卡牌和排名数据工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Chat Royale

使用 Gemini 2.0 和 MCP 工具访问实时游戏数据的 AI 驱动《Clash Royale》Agent。

完整技术深入解析

我最近撰写了一篇技术文章，深入介绍了该项目的架构、构建过程以及其他有趣的内容。你可以在以下网站阅读：

完整技术深入解析

架构

由三个容器化服务组成：

MCP Server（src/mcp/）——提供《Clash Royale》API 工具的 Python FastMCP 服务：

  • 玩家、部落、卡牌、排行榜

Backend API（src/backend/）——Node.js/Express 服务：

  • 通过 @modelcontextprotocol/sdk 将 Gemini 与 MCP 客户端集成
  • 使用标准 JSON 请求/响应（不支持流式传输）
  • 通过迭代调用 Gemini 在内部处理工具执行

Frontend（src/frontend/）——React/TypeScript 界面：

  • 支持 Markdown 的简易聊天界面
  • 向后端 API 发送标准 HTTP 请求

工作原理

  1. 用户向前端发送消息
  2. 前端向后端的 /api/chat 发送请求
  3. 后端连接 MCP 服务并发现可用工具
  4. Gemini 使用可用工具处理消息
  5. 如果需要工具：后端通过 MCP 执行工具，并将结果反馈给 OpenAI
  6. 最终响应以 JSON 格式返回给前端

部署

生产环境：AWS Lightsail 搭配 Cloudflare CDN

CI/CD：推送或合并到 main 分支时，GitHub Actions 会自动部署

# Deploy
docker-compose -f docker-compose.prod.yml up -d --build

开发

# Environment setup
# Backend: src/backend/.env - GEMINI_API_KEY
# MCP: src/mcp/.env - CR_API_KEY

# Run all services
docker-compose up -d

技术栈

  • MCP Server：Python 3.12、FastMCP、Clash Royale API
  • Backend：Node.js、Express、TypeScript、Gemini SDK
  • Frontend：React、TypeScript、Vite、TailwindCSS
  • 部署：Docker、AWS Lightsail、Cloudflare、GitHub Actions

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。