AI导哈

Umamusume训练MCP服务器

一个为游戏《Umamusume Pretty Derby》提供AI辅助工具的MCP服务器，支持冠军赛信息查询、评分计算和耐力验证功能。

  • by JemiloII
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 JemiloII/mcp-server

使用说明

🏇 Umamusume训练器-MCP服务器

一个模型上下文协议（MCP）服务器，为游戏《Umamusume Pretty Derby》提供AI驱动的工具。此服务器使Claude AI能够帮助您获取冠军会议信息、评级计算和耐力验证。

✨ 特性

此MCP服务器提供三个强大的工具：

🏆 冠军会议

获取冠军大会活动的详细信息：

  • 当前、上一个或下一个 -按范围查询会议
  • 以名称搜索 -查找特定的冠军会议
  • 返回场地、表面、距离、类别、方向、条件、季节和天气信息

📊 评级计算器

在职业生涯结束前计算你的Umamusume评分：

  • 分析游戏截图中的统计数据
  • 处理技能并验证每个统计数据
  • 提供详细的评级计算
  • 每天自动更新数据以确保准确性

⚡ 验证体力

检查你的Umamusume是否有足够的耐力参加冠军杯：

  • 验证特定比赛的耐力要求
  • 帮助优化您的训练策略

🚀 快速开始

先决条件

  • Node.js>=24.0.0
  • pnpm包管理器

安装

  1. 克隆仓库

    git clone <your-repo-url>
cd mcp-server

  2. 安装依赖项

    pnpm install

  3. 构建项目

    pnpm run build

  4. 启动服务器

    pnpm run server

    服务器将于启动 http://localhost:5096

发展模式

对于热重载开发：

pnpm run dev

🌐 与克劳德一起使用

选项1：克劳德·韦伯（Claude.ai）

重要提示： Claude Web需要HTTPS（端口80/443）和有效的SSL证书。您需要使用以下方法之一公开您的服务器：

使用Cloudflare隧道（推荐）

  1. 安装 Cloudflare隧道
  2. 验证并创建隧道：
    cloudflared tunnel login
cloudflared tunnel create umamusume-trainer
  3. 运行隧道：
    cloudflared tunnel --url http://localhost:5096
  4. 复制提供的HTTPS URL

使用ngrok

  1. 安装 吸烟
  2. 运行：
    ngrok http 5096
  3. 复制提供的HTTPS URL

连接到Claude Web

  1. 首选 claude.ai
  2. 打开任何对话
  3. 点击 主控程序 输入区域中的图标（拼图块）
  4. 点击 “添加服务器”
  5. 输入MCP发现URL：
    https://umamusume.training/.well-known/mcp.json
  6. 服务器将自动连接

选项2：克劳德桌面

macOS/Linux配置

  1. 打开克劳德桌面设置
  2. 导航至 开发者 → 编辑配置
  3. 将服务器配置添加到 claude_desktop_config.json:
{
  "mcpServers": {
    "umamusume-trainer": {
      "url": "https://umamusume.training"
    }
  }
}
  1. 重新启动克劳德桌面

Windows配置

  1. 打开 %APPDATA%\Claude\claude_desktop_config.json
  2. 添加与上述相同的配置
  3. 重新启动克劳德桌面

📋 服务器端点

  • MCP端点： /mcp 或 /
  • 发现： /.well-known/mcp.json
  • 健康检查： /health

🛠️ 技术细节

  • 协议版本： 2025-06-18
  • 运输： 流式HTTP
  • 默认端口： 5096
  • 框架： 荣誉
  • 运行时间： Node.js

🎯 使用示例

连接到Claude后，您可以提出以下问题：

  • “目前的冠军赛是什么？”
  • “使用以下统计数据计算我的Umamusume的评分：[提供统计数据]”
  • “我的Umamusume有足够的耐力参加下一届冠军赛吗？”
  • “查找有关冬季冠军赛的信息”

📝 发展

项目结构

mcp-server/
├── src/
│   ├── index.ts          # Main server setup
│   ├── server.ts         # Server entry point
│   └── tools/            # MCP tools
│       ├── champions_meeting.ts
│       ├── rating_calculator/
│       └── validate_stamina/
├── public/
│   └── index.html        # Homepage
└── package.json

可用脚本

  • pnpm run dev -热装开发模式
  • pnpm run build -将TypeScript构建为JavaScript
  • pnpm run start -启动生产服务器
  • pnpm run server -使用env文件启动开发服务器

🔧 故障排除

服务器无法连接到Claude Web

  • 确保您使用的是带有有效SSL证书的HTTPS
  • 验证 /.well-known/mcp.json 端点可访问
  • 检查端口80或443是否正确转发

服务器无法连接到Claude Desktop

  • 验证配置中的URL是否匹配 https://umamusume.training
  • 检查配置文件路径和JSON语法
  • 配置更改后重新启动Claude Desktop
  • 检查Claude Desktop开发人员控制台中的日志

工具未出现在Claude中

  • 确认服务器正在运行(/health 端点应返回 {"status":"ok"})
  • 检查MCP发现端点是否返回有效的JSON
  • 验证协议版本兼容性

🤝 贡献

欢迎投稿！请随时提交拉取请求。

📚 资源

相关 MCP