amiyabot/amiya-bot-mcp-server

Developer tools

This page was translated automatically. Technical details may differ from the original. View the original

4 stars 4 forks Quality 65 Trend 32

Repository Install

AmiyaBot MCP Server

Overview

AmiyaBot MCP Server 是面向《明日方舟》数据查询的 MCP 服务。它基于本地游戏资源提供结构化数据和图片卡片，并附带命令行工具 amiyabot-cli。 1.0.8 版本支持查询干员、技能、精英化与技能升级材料、模组、召唤物、皮肤、材料、关卡、敌人、公开招募、集成战略藏品与主题机制道具和游戏术语。 - 通过统一搜索查找干员、召唤物、皮肤、材料、关卡、敌人、集成战略藏品、剧目、骰子、密文板、构想、通宝和零件 - 返回结构化数据，并为适合展示的内容生成图片卡片 - 通过 Streamable HTTP 提供 MCP 服务，可接入支持远程 MCP 的客户端 - 提供 CLI、Docker 和 Helm 三种使用方式 - 支持资源首次初始化、后台更新和版本查询服务启动后会立即尝试同步旧版 AmiyaBot 全局别名表，之后每小时刷新一次。别名参与精确、包含和相似度搜索，但不会形成独立的“别名”类型；命中项仍是对应的干员、敌人或材料，并额外返回 from_alias 表示实际命中的别名。同步失败时继续使用上一次成功的内存快照，不影响正式名称搜索。统一搜索存在多个候选时会按类型生成选择卡，图片中的序号与结构化 items 顺序一致。选择卡使用全部有序结果 ID 的 SHA-256 作为缓存键，因此返回相同候选和顺序的别名查询可以复用卡片；缓存按条目数和字节数双重限制执行 LRU 淘汰。可以通过 Docker、Helm 或本地安装运行 AmiyaBot MCP Server。首次启动时，容器会自动把游戏资源下载到挂载目录；所需时间取决于网络和磁盘性能。建议为资源、缓存和日志预留至少 20 GiB 空间。 Chart 默认创建 PVC 并将其挂载到 /app/resources。已有 PVC 可以通过 persistence.existingClaim 指定；不需要 Ingress 时，将 ingress.enabled 设置为 false。Streamable HTTP 包含长连接响应，使用 NGINX Ingress 时建议关闭响应缓冲并调大读写超时，如上例所示。

Install

docker run -d \

New to MCP? Start with the mcpskill.org guide →

Configuration

{
  "mcpServers": {
    "amiya-mcp": {
      "transport": "streamable-http",
      "url": "http://127.0.0.1:9000/mcp"
    }
  }
}