Destiny MCP
Manage your Destiny 2 inventory, weapons, and loadouts through AI. Integrates with MCP clients like Claude Code.
README
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/。
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.