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.py

setup.py 会交互式引导你完成：

• 填入 Bungie API 凭证
• 完成 OAuth 授权
• 下载游戏数据库

完成后，在 Claude Code 中打开此项目即可使用。

检查环境

uv run python scripts/doctor.py

检查所有配置是否就绪，包括 API 连通性测试。

手动配置

如果一键脚本不适用，按以下步骤手动操作：

1. Bungie API 凭证

前往 Bungie 开发者门户 创建应用：

• Redirect URL: https://localhost:8765/callback
• Origin 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 配置好。

其他客户端参考 安装指南。

可用工具

工具	说明
search_player	查找玩家
get_profile	角色概览
get_inventory	背包/仓库物品
search_items	搜索物品位置
move_item	移动/装备物品
find_build	配装求解
get_weapon_perks	武器 perk 池
compare_weapon_instances	对比武器副本
get_vendor_inventory	商人库存
get_weekly_reset	本周重置活动
...	更多见 工具文档

常见问题

浏览器提示「连接不安全」？ 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/。