# Destiny MCP

通过 AI 管理你的 Destiny 2 装备、武器和配装。

支持 Claude Code、Claude Desktop、Cursor 等任何 MCP 客户端。

## 快速开始

```bash
# 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 中打开此项目即可使用。

## 检查环境

```bash
uv run python scripts/doctor.py
```

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

## 手动配置

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

### 1. Bungie API 凭证

前往 [Bungie 开发者门户](https://www.bungie.net/en/Application) 创建应用：
- Redirect URL: `https://localhost:8765/callback`
- Origin Header: `*`
- Scope: 勾选 Read/Move/Equip

### 2. 环境变量

```bash
cp .env.example .env
# 编辑 .env 填入凭证
```

### 3. OAuth 授权

```bash
uv run python scripts/oauth_setup.py
```

浏览器会打开 Bungie 授权页面，授权后 token 自动保存到 `~/.destiny_mcp/tokens.json`。

### 4. MCP 配置

项目根目录的 `.mcp.json` 已为 Claude Code 配置好。

其他客户端参考 [安装指南](docs/installation.md)。

## 可用工具

| 工具 | 说明 |
|------|------|
| `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` | 本周重置活动 |
| ... | 更多见 [工具文档](prompts/system_prompt.md) |

## 常见问题

**浏览器提示「连接不安全」？**
OAuth 回调用自签名证书，点「高级 → 继续前往」即可，仅本机使用无安全风险。

**Token 过期了？**
不会。`tokens.json` 含 refresh_token，启动时自动刷新。如改了 Bungie 密码需重新跑 OAuth。

**首次启动很慢？**
首次会自动下载 Manifest (~50MB)，之后会缓存。

## 开发

```bash
uv run pytest tests/ -v          # 运行测试
uv run ruff check src/ tests/    # 代码检查
uv run ruff format src/ tests/   # 格式化
```

架构文档见 [docs/](docs/)。