Destiny MCP
Allows AI agents to manage Destiny 2 equipment, weapons, and builds through the Bungie API, including inventory transfer, weapon analysis, build recommendations, and activity history.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Destiny MCP show my highest stat roll for each armor slot on my hunter"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Destiny MCP
通过 AI 管理你的 Destiny 2 装备、武器和配装。
支持 Claude Code、Claude Desktop、Cursor 等任何 MCP 客户端。
快速开始
# 1. 克隆项目
git clone <repo> && cd Destiny_MCP
# 2. 安装依赖 (需要 uv)
uv sync
# 3. 一键配置 (引导你完成所有设置)
uv run python scripts/setup.pysetup.py 会交互式引导你完成:
填入 Bungie API 凭证
完成 OAuth 授权
下载游戏数据库
完成后,在 Claude Code 中打开此项目即可使用。
Related MCP server: Destiny MCP
仓库结构
src/destiny_mcp/ MCP 后端和业务服务
webui/ 当前生产 React 前端和静态宿主
webui_new/ Hermes 兼容 API 后端和 legacy 回滚界面
tests/ MCP/服务聚焦测试
prompts/ 模型系统提示和截图提取提示
scripts/ 安装、检查、数据导入和运维脚本
deploy/ Docker/Nginx 检查与部署文件
docs/ 架构、运维、产品和参考文档
archive/ 不参与生产构建的历史原型/发布快照
data/ 本地 OAuth/会话运行数据(禁止删除,Git 忽略)
manifest/ 可重新下载的 Bungie Manifest(Git 忽略)完整说明见 仓库布局。
导入武器选取率 JSON
将多模态模型输出保存为 JSON,然后运行:
uv run python scripts/import_weapon_popularity.py /path/to/weapon.json导入器会严格校验结构、拒绝默认覆盖同名武器,在 data/backups/weapon-popularity/ 保留备份后原子更新内置数据。明确替换旧快照时使用 --replace。截图提取规则见 多模态提示词。
检查环境
uv run python scripts/doctor.py检查所有配置是否就绪,包括 API 连通性测试。
手动配置
如果一键脚本不适用,按以下步骤手动操作:
1. Bungie API 凭证
前往 Bungie 开发者门户 创建应用:
Redirect URL:
https://localhost:8765/callbackOrigin Header:
*Scope: 勾选 Read/Move/Equip
2. 环境变量
cp .env.example .env
# 编辑 .env 填入凭证3. OAuth 授权
uv run python scripts/oauth_setup.py浏览器会打开 Bungie 授权页面,授权后 token 自动保存到 ~/.destiny_mcp/tokens.json。
4. MCP 配置
项目根目录的 .mcp.json 已为 Claude Code 配置好。
其他客户端参考 安装指南。
可用工具
默认 DESTINY_MCP_TOOL_PROFILE=normal,只向模型暴露 8 个稳定的聚合入口:
工具 | 覆盖能力 |
| 玩家搜索、角色档案 |
| 背包、转移、批量装备、邮政官、锁定、任务追踪 |
| 武器分析、同名对比、perk 池、选取率、条件筛选 |
| 护甲配装推荐、诊断、确认后装备 |
| 本地配装和 Bungie 官方配装槽 |
| 子职业、碎片、神器 |
| 活动历史、PGCR、武器统计、排行榜 |
| 周常、商人、收藏品状态 |
expert 会增加常用只读工具,full 会暴露全部 76 个工具用于旧客户端兼容和调试。完整路由与确认规则见 工具文档。
常见问题
浏览器提示「连接不安全」? OAuth 回调用自签名证书,点「高级 → 继续前往」即可,仅本机使用无安全风险。
Token 过期了?
不会。tokens.json 含 refresh_token,启动时自动刷新。如改了 Bungie 密码需重新跑 OAuth。
首次启动很慢? 首次会自动下载 Manifest (~50MB),之后会缓存。
开发
uv run pytest tests/ -v # 运行测试
uv run ruff check src/ tests/ # 代码检查
uv run ruff format src/ tests/ # 格式化架构文档见 docs/。
Available Tools
8 toolsactivity_assistantC
活动/战绩聚合入口:历史、PGCR、生涯统计、武器使用、排行榜。
Inputs: mode, count, intent, maxtop, +5 more.
build_assistantB
配装聚合入口:推荐、查候选、失败诊断、确认后装备。
priority_stats 按从高到低严格排序;include_subclass_fragment=True 时使用目标角色当前已装备的子职业和碎片属性。
Inputs: top_n, intent, character, confirmed, +15 more.
inventory_assistantC
背包/仓库聚合入口:查物品、筛位置、移动/装备/锁定前统一确认。
Inputs: equip, limit, intent, locked, +15 more.
loadout_assistantC
配装槽聚合入口:本地/官方配装读取、保存、装备、官方槽位管理。
Inputs: kind, name, notes, query, +9 more.
player_assistantC
玩家/账号聚合入口:搜索玩家、模糊找人、读取角色档案。
Inputs: intent, name_prefix, player_name.
subclass_assistantC
子职业/碎片/神器聚合入口:读取配置、查选项、确认后修改。
Inputs: intent, changes, element, character, +7 more.
weapon_assistantD
武器聚合入口:分析、同名对比、perk 池、选取率、按 perk 筛选。
Inputs: limit, intent, location, any_perks, +8 more.
world_assistantC
世界/周常聚合入口:商人、周常、收藏品和进度查询。
Inputs: limit, query, intent, character, +5 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool targets a distinct aspect of the Destiny game (activities, builds, inventory, loadouts, players, subclasses, weapons, world), with no overlapping purposes. The descriptions clearly differentiate their roles.
All tool names follow a consistent pattern of `[noun]_assistant`, making it easy to predict functionality from the name alone.
8 tools is an appropriate number for a Destiny game assistant, covering all major game systems without being overwhelming or sparse.
The tools cover all core player interactions: activities, character builds, inventory management, loadouts, player search, subclass modifications, weapon analysis, and world/weekly content. There are no obvious missing features for the domain.
Maintenance
Related MCP Connectors
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.
Create AI Characters and generate their DM and comment replies from any MCP client.
Persistent memory, knowledge graph, task management and more for AI agents via MCP.
A registry of AI agent tools — MCP servers, APIs, CLIs, SDKs — kept current by automated ingestion.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that integrates EVE Online's ESI API with AI assistants to enable natural language interaction with character data, market information, and assets. It provides 22 tools for managing skills, wallet balances, ship fittings, and more directly through AI-powered clients.2MIT
- FlicenseNot gradedqualityDmaintenanceManage your Destiny 2 inventory, weapons, and loadouts through AI. Integrates with MCP clients like Claude Code.1-
- FlicenseNot gradedqualityDmaintenanceMCP server that provides full read/write access to the Bungie API for Destiny 2, enabling AI assistants to manage inventory, equipment, loadouts, subclass configuration, vendors, and account stats for a user's Destiny 2 characters. It runs locally with OAuth authentication and exposes 23 tools for comprehensive game management.-
- FlicenseNot gradedqualityDmaintenanceA read-only MCP server that enables AI assistants to access a user's Steam library, playtime, achievements, friends, wishlist, and store data for backlog analysis, game recommendations, discount monitoring, and play-activity summaries.-