TokRepo MCP Server について
TokRepo MCP Serverは、スキル、プロンプト、MCP設定、ワークフローなどの再利用可能なAIアセットのレジストリに、AIアシスタントを接続します。検索や信頼性確認、インストール計画、Codexのライフサイクル管理、ユーザー確認後の公開に対応します。
主な機能
- 01AIアセットの検索とランキング
- 02アセットの詳細と依存関係の確認
- 03信頼性、権限、証拠の検証
- 04Codexインストールの計画と管理
- 05再利用可能なアセットの準備と公開
活用シーン
- 01能力不足を補うアセットの検索
- 02有効化前の安全性確認
- 03管理対象のCodexインストールの更新やロールバック
- 04ローカルの成果物を公開用に整理
MCP 対応
MCPクライアントにTokRepoの検索、検証、インストール計画、ライフサイクル管理、公開のツールを提供します。stdioを介してClaude Code、Cursor、Windsurf、OpenAI Codex、Gemini CLIなどと連携します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
17掲載時のツール一覧 · 3 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| project_hint | string | いいえ | アセット一覧の優先度を調整するための任意のプロジェクトシグナル(パスの basename、package.json の名前、またはリポジトリの説明)。 |
| target | enum | いいえ | 任意のエージェント実行時ターゲット。any | all | codex | claude_code | gemini_cli | cursor | copilot | cline | windsurf | roo | openhands | aider | mcp_client |
| compact | boolean | いいえ | 候補ごとに超簡潔な応答(各項目 ≤50 トークン)を返します。デフォルトは true です。 |
詳細
TokRepo MCP サーバー
TokRepo 向けのエージェントネイティブな MCP サーバーです。セッションの初期化、機能の検出、検索と詳細の取得、信頼性の検証、インストール計画、Codex へのステージング、ライフサイクルの確認・更新・アンインストール・ロールバック、引き継ぎと収集の計画、および再利用可能な AI アセットの人間による確認付き公開に対応します。
クイックスタート
Claude Code
claude mcp add tokrepo -- npx -y tokrepo-mcp-server
Cursor / Windsurf
MCP 設定(~/.cursor/mcp.json)に追加します:
{
"mcpServers": {
"tokrepo": {
"command": "npx",
"args": ["-y", "tokrepo-mcp-server"]
}
}
}
OpenAI Codex / Gemini CLI
codex mcp add tokrepo -- npx -y tokrepo-mcp-server
gemini settings mcp add tokrepo -- npx -y tokrepo-mcp-server
機能
接続すると、AI アシスタントは次の操作を行えます:
- 計画中に検出 — タスクや機能の不足を、スキル、プロンプト、MCP 設定、スクリプト、ワークフローの構造化された候補に変換します
- 機能の不足を解消 — ローカルで構築する前に、検証の根拠、インストール計画、ライフサイクル契約、次に呼び出す MCP、CLI の代替手段を含む候補を選択します
- 検索 — エージェントとの適合性を示す情報を用いて、キーワードまたはカテゴリで公開 AI アセットを検索します
- 閲覧 — 人気のアセットを確認し、種類(MCP、スキル、プロンプト、エージェント、スクリプト)で絞り込みます
- 詳細を取得 — 完全なドキュメント、インストール手順、メタデータを取得します
- 信頼性を検証 — 読み取り専用で、コンテンツハッシュ、インストール計画のハッシュ、権限の範囲、ポリシー、trust_score_v2、
evidence_bundle、SBOM-lite、signature_evidence、ブロッカー、警告を確認します - インストール前に計画 — ポリシーの判断、ロールバック、検証、
evidence_bundle、SBOM-lite、signature_evidenceを含む install plan v2 を取得します - 安全な Codex インストール — デフォルトではドライランを実行し、リスクのあるアセットはステージングするか、明示的に承認する必要があります
- ライフサイクル管理 — 管理対象の Codex インストールを一覧表示、更新、アンインストール、ロールバックします
- タスク後の収集 — プッシュする前に、
tokrepo_harvestを使って変更されたローカルファイルまたは明示的に指定されたローカルファイルを確認します。非公開パッケージのドラフト、quality_gate、パッケージマニフェスト、SBOM-lite、来歴も含まれます - プロジェクトメモリ —
tokrepo init-agent --target allと組み合わせることで、今後のエージェントが計画中に TokRepo を呼び出すようにします - 検出用エンドポイント — 公式 MCP
server.json、A2A エージェントカード、ポータブルなエージェントマニフェスト、ツールカタログ、.well-known、agents.txt、llms.txt、npm メタデータを、エージェントとレジストリが利用できる機械可読形式で維持します - ファネルの可視化 — 匿名の集計イベントにより、エージェントが実際に再利用可能なアセットを検出、計画、インストール、引き継ぎ、プッシュしているかを確認できます
利用可能なツール
| ツール | 説明 |
|---|---|
tokrepo_session_init | 信頼度の高いアセット、プロジェクトメモリの参照先、最近の引き継ぎ情報、ポリシーパックの URL を含むセッションの初期化 |
tokrepo_discover | タスク、環境、制約に基づく計画時の機能探索 |
tokrepo_find_for_task | 具体的なタスクに対するアトミックな検索アクション。ランク付けされたアセット、一致理由、インストールコマンド、URL を返します |
tokrepo_resolve_capability | 機能の不足を、選択したアセット、検証の証拠、インストール計画、ライフサイクル契約、次の MCP 呼び出し、CLI の代替手段に解決します |
tokrepo_search | agent_fit によるランキングを使い、キーワードやタグでアセットを検索します |
tokrepo_detail | UUID でアセットの詳細を取得します |
tokrepo_edges | インストール計画の前に、依存、拡張、共用アセットのグラフエッジを確認します |
tokrepo_install_plan | ロールバック、evidence_bundle、SBOM-lite、signature_evidence を含む、エージェント向けネイティブなインストール計画 v2 を取得します |
tokrepo_verify | 有効化の前に、信頼性、ハッシュ、権限、ポリシー、evidence_bundle、SBOM-lite、signature_evidence を検証します |
tokrepo_codex_install | Codex スキルを安全にドライラン、ステージング、またはインストールします |
tokrepo_installed | TokRepo が管理する Codex のインストールを一覧表示します |
tokrepo_update | 管理対象の Codex インストールをドライランまたは更新します |
tokrepo_uninstall | 管理対象の Codex インストールをドライランまたは削除します |
tokrepo_rollback | 以前の Codex インストールセッションをドライランまたはロールバックします |
tokrepo_handoff_plan | タスク後に再利用可能なローカル作業をまとめるための、quality_gate とパッケージマニフェストを含む読み取り専用のパッケージ化計画 |
tokrepo_harvest | タスク後に変更されたローカルファイル、または明示されたローカルファイルを再利用するための、読み取り専用のパッケージ下書き生成ツール |
tokrepo_push | ユーザーの確認後、明示された 1 つのアセットを TokRepo にプッシュします |
会話の例
You: "Find me a good MCP server for databases"
AI: [calls tokrepo_resolve_capability] → Ranks DBHub, Supabase MCP, PostgreSQL MCP and returns verification/install-plan evidence for the selected candidate
You: "What video assets should I install?"
AI: [calls tokrepo_resolve_capability] → Finds relevant skills, checks fit, trust, and policy, then asks before installing
You: "Install that cursor rules asset"
AI: [calls tokrepo_verify] → Checks trust_score_v2, permissions, blockers, and warnings
AI: [calls tokrepo_install_plan] → Reviews policy and actions
AI: [calls tokrepo_codex_install with dry_run=false, confirm=true] → Writes only after explicit confirmation
AI: [calls tokrepo_rollback with dry_run=true] → Shows exactly what would be removed before rollback
You: "We created a reusable project rule; save it for future agents"
AI: [calls tokrepo_harvest] → Returns explicit files, hashes, quality_gate, package drafts, SBOM-lite, provenance, metadata defaults, and private-by-default push guidance
AI: [asks for confirmation before tokrepo_push] → Uploads only reviewed files
今後のエージェントが TokRepo を見つけられるようにする
プロジェクトで一度実行します。
npx tokrepo init-agent --target all
これにより、管理対象の指示が AGENTS.md、CLAUDE.md、GEMINI.md、Cursor のルール、GitHub Copilot の指示、Cline のルール、Windsurf のルール、Roo のルール、OpenHands のマイクロエージェント、Aider の規約、.mcp.json、.tokrepo/agent.json に書き込まれます。ルールはシンプルです。計画中にエージェントが機能の不足に気づいたら、その場しのぎのローカルツールを作る前に tokrepo_resolve_capability または tokrepo_discover を呼び出します。タスクの後、エージェントは tokrepo_harvest を呼び出すか、tokrepo harvest --changed --json を実行して、ユーザー確認のもとで非公開で公開する再利用可能なファイルを提案できます。
機械可読な掲載情報
レジストリやエージェントは、以下を通じてこのサーバーを検出できます。
- MCP サーバーマニフェスト:tokrepo.com/.well-known/mcp/server.json
- TokRepo マニフェスト:tokrepo.com/.well-known/tokrepo.json
- ポータブルエージェントマニフェスト:tokrepo.com/.well-known/agent.json
- A2A エージェントカード:tokrepo.com/.well-known/agent-card.json
- ツールカタログ:tokrepo.com/.well-known/tool-catalog.json
- 信頼マニフェスト:tokrepo.com/.well-known/tokrepo-trust.json
- デフォルトのエージェントポリシーパック:tokrepo.com/policy-packs/default-agent-policy.json
- 評価エビデンス:tokrepo.com/evals/agent-discovery.json
- マルチエージェント互換性:tokrepo.com/evals/multi-agent-compatibility.json
- エージェントメモリスキーマ:tokrepo.com/schemas/agent-memory.schema.json
- エージェントエビデンスバンドルスキーマ:tokrepo.com/schemas/agent-evidence-bundle.schema.json
- ケイパビリティ解決スキーマ:tokrepo.com/schemas/capability-resolution.schema.json
- 収集レポートスキーマ:tokrepo.com/schemas/harvest-report.schema.json
- ハンドオフパッケージスキーマ:tokrepo.com/schemas/handoff-package.schema.json
- エージェント向けテキストエントリー:tokrepo.com/agents.txt
- エージェント向け指示:tokrepo.com/agent-instructions/tokrepo.md
- エージェントエコシステム配布パック:tokrepo.com/agent-ecosystem.json
- LLM クローラーエントリー:tokrepo.com/llms.txt
エージェントマーケットプレイスへの掲載、スターターテンプレート、README のスニペット、インストールガイド、サンプルプロジェクトには、https://tokrepo.com/agent-ecosystem.json を使用してください。標準の掲載文、エコシステムのチャネル、対象となるプロジェクトメモリファイル、検証コマンドが含まれています。
TokRepo は、tokrepo_resolve_capability、tokrepo_discover、tokrepo_verify、tokrepo_install_plan、インストールのドライラン、インストール、収集、ハンドオフ、プッシュについて、匿名の集計ファネルイベントを送信します。タスクのテキストやファイルの内容は送信しません。TOKREPO_TELEMETRY=0 で無効にできます。
TokRepo を選ぶ理由
TokRepo は AI アセットのオープンレジストリ です。パッケージ向けの npm のように、AI スキル、プロンプト、MCP 設定、ワークフローを対象としています。
- 厳選されたアセット — 品質審査済みで、単なる寄せ集めではありません
- エージェントネイティブ — すべてのアセットに機械可読なインストールコントラクトがあります
- 汎用的 — Claude Code、Cursor、Codex、Gemini CLI、あらゆる MCP クライアントで動作します
- CLI を利用可能 —
npx tokrepo search "query"/npx tokrepo install <uuid>
要件
- Node.js >= 18
- インターネット接続(tokrepo.com API に問い合わせます)
リンク
- ウェブサイト:tokrepo.com
- CLI:npm: tokrepo
- GitHub:henu-wang/tokrepo-mcp-server
- API:tokrepo.com/.well-known/tokrepo.json
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。