swipe-mcp
MCP server for managing swipe files (sample/reference data) with tools to add, search, and update entries via Claude.
README
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/→ 稼働状況の JSONhttps://swipe-mcp.<アカウント名>.workers.dev/diag→ Secrets と Supabase 接続の診断
6. Claude への接続
シアニン担当プロジェクトのコネクタとして https://swipe-mcp.<アカウント名>.workers.dev/mcp を追加する。
まだ入っていないもの
- Zeus 索引への自動連携（F5）：登録時の push は次のブロックで実装する
- ファイル取り込み（F7）：画面アップロードのみの機能で、MCP 側には作らない
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.
Neon Database
MCP server for interacting with Neon Management API and databases
E2B
Using MCP to run code via e2b.
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.