# swipe-mcp

スワイプファイル（お手本・見本データ）専用の MCP サーバー。Claude から `swipe__*` ツールで
素材の登録・検索・参照ができる。

- 要件：Notion「スワイプファイルアプリ 要件定義 v1.7」§F4
  https://app.notion.com/p/3ab9c6c1c439817abee4ee95f6a8a906
- 方式：**shia2n-mcp 本体とは完全に独立した Worker**（本体には追加しない・パス分割方式は使わない）
- 接続範囲：シアニン担当プロジェクトのみ

```
Claude（シアニン担当プロジェクト）
  ↓ MCP（OAuth / Bearer）
swipe-mcp（このアプリ・Cloudflare Workers）
  ↓ Supabase REST（service role）
sw_swipes / sw_zeus_orphans
```

---

## 提供するツール（7本）

| ツール | 参照回数 | 内容 |
|---|---|---|
| `swipe__add` | 増えない | 1件登録。`reason` 必須、`url` か `body` のいずれか必須 |
| `swipe__bulk_add` | 増えない | 複数件まとめて登録（最大50件）。失敗した件だけ理由を返す |
| `swipe__search` | **増えない** | 条件検索。既定は登録日降順、`sort=ref` のときだけ参照が多い順 |
| `swipe__get` | **+1** | ID指定で1件フル取得（`body` 含む） |
| `swipe__update` | 増えない | 部分更新。参照回数は更新できない |
| `swipe__mark_used` | **増えない** | 活用済マーク＋活用先の記録 |
| `swipe__list_tags` | 増えない | 使用中タグの一覧（表記ゆれ確認用） |

ファイル投入用のツールは作らない。AI は投入時点で中身をテキストで読めているため、
`swipe__add` の `body` に渡せば足りる（要件 §F4）。

---

## セットアップ

### 1. GitHub リポジトリ
`swipe-mcp` という名前で作成し、このファイル一式を Upload files で置く。

### 2. KV 名前空間
Cloudflare → Storage & Databases → KV → 名前空間 `swipe-mcp-oauth` を作成し、
その ID を `wrangler.jsonc` の `kv_namespaces[0].id` に入れる。

**shia2n-mcp と同じ名前空間を共用しないこと。**共用すると片方で発行した接続用トークンが
もう片方でも通ってしまう。

### 3. Cloudflare Workers（GitHub連携）
Workers & Pages → Create → Workers → Import a repository → `swipe-mcp`

- Build command : `npm install`
- Deploy command: `npx wrangler deploy`
- Root directory: （空欄）

### 4. Secrets（Settings → Variables and Secrets）

| 名前 | 値 |
|---|---|
| `MCP_SERVER_SECRET` | 新規のランダム文字列（64文字以上）。**shia2n-mcp とは別の値にする** |
| `MCP_DEFAULT_USER_ID` | Naoki の Firebase UID（スワイプアプリと同じ値） |
| `SUPABASE_URL` | 既存アプリと同じ |
| `SUPABASE_SERVICE_ROLE_KEY` | 既存アプリと同じ |
| `ANTHROPIC_API_KEY` | 既存アプリと同じ（AI補完用） |

### 5. 動作確認
- `https://swipe-mcp.<アカウント名>.workers.dev/` → 稼働状況の JSON
- `https://swipe-mcp.<アカウント名>.workers.dev/diag` → Secrets と Supabase 接続の診断

### 6. Claude への接続
シアニン担当プロジェクトのコネクタとして `https://swipe-mcp.<アカウント名>.workers.dev/mcp` を追加する。

---

## まだ入っていないもの

- **Zeus 索引への自動連携（F5）**：登録時の push は次のブロックで実装する
- **ファイル取り込み（F7）**：画面アップロードのみの機能で、MCP 側には作らない