toolcairn-mcp

@neurynae/toolcairn-mcp

npm の @neurynae/toolcairn-mcp のソースです。このリポジトリからではなく、パッケージをインストールしてください。

ToolCairn は、AI コーディングエージェントを、npm、PyPI、Cargo、Maven、Go、Composer、RubyGems、NuGet、Homebrew、その他 35 以上のレジストリにわたる、継続的に更新される 30,000 以上のオープンソースツールのグラフに接続する MCP サーバーです。Claude Code、Cursor、その他の MCP 互換クライアント内から、検索、比較、スタックの構築、バージョン互換性の確認を行えます。

具体例。 エージェントに 「Node 用の高速な HTTP クライアントが必要」 と伝えると、エージェントは search_tools を呼び出します。ToolCairn は、メンテナンス状況やコミュニティの指標、代替候補とともに、順位付けされた候補を返し、最有力候補の活動状況に疑問がある場合は警告します。ブログ記事や古いチュートリアルを頼りに推測する必要はもうありません。

MCP サーバーは、エージェントの stdio 子プロセスとしてローカルで実行されます。ツール呼び出しは MCP 経由でこのパッケージに送られ、ネットワーク通信を伴う呼び出しは ToolCairn Cloud API に中継され、ローカルのみで完結する処理（プロジェクトスキャン、設定、監査ログ）はディスク上で処理されます。

---

ToolCairn を選ぶ理由

通常のウェブ検索や LLM の学習データだけでは、ツールの選定には不十分です。知識のカットオフにより最新リリースが反映されず、検索エンジンでは信頼できるランキングよりチュートリアルが上位に表示され、バージョン互換性に関する情報は各所のイシュースレッドに散在しています。

ToolCairn は、生のレジストリ API だけでは得られない次の 3 つの機能で、これらの課題を解決します。

• グラフを考慮したランキング — 人気度だけでなく、ツール同士の関係（依存関係、連携、置き換え、競合）も考慮しておすすめを提示します。
• バージョンを考慮した互換性 — 宣言されたピア依存関係の範囲とレジストリをまたいだバージョンメタデータにより、「どちらも人気があるので、おそらく問題ない？」 ではなく、「Next.js 14 には React 18.x が必要」 といった情報を得られます。
• 継続的な学習ループ — 採用、却下、置き換えられたおすすめはすべてグラフにフィードバックされるため、使うほど品質が向上します。

---

クイックスタート

ステップ 1. 無料アカウントを toolcairn.neurynae.com/signup で作成します。

ステップ 2. MCP 設定に追加し、エージェントを再起動します。

{
  "mcpServers": {
    "toolcairn": {
      "command": "npx",
      "args": ["@neurynae/toolcairn-mcp"]
    }
  }
}

ステップ 3. 初回起動時にサインイン用のブラウザーウィンドウが開きます。確認すると、追加の設定なしですぐにすべてのツールを利用できます。

Node.js 22 以降が必要です。

---

セットアップ — Claude Code

最も簡単な方法：

claude mcp add toolcairn -- npx @neurynae/toolcairn-mcp

または、上記の JSON ブロックを ~/.claude/claude_desktop_config.json の mcpServers の下に貼り付けてください。

ほかの MCP 対応クライアント（Cursor、Claude Desktop、VS Code Copilot、Windsurf、Zed、…）でも同じ npx @neurynae/toolcairn-mcp コマンドを使用できます。クライアントごとの設定ファイルの場所については、ドキュメントをご覧ください。

---

できること

ツールを見つける

エージェントに 「イベントトラッキング用のリアルタイム分析データベースが必要です」 と伝えると、search_tools を呼び出し、メンテナンス状況のシグナルとともに、ランキングされた候補（ClickHouse、TimescaleDB、InfluxDB、…）を取得します。意図が曖昧な場合、応答には確認の質問が含まれます。エージェントが search_tools_respond で回答すると、絞り込まれた結果を取得できます。

スタックを構築する

エージェントに 「フルスタックの TypeScript SaaS の設計を手伝ってください」 と伝えると、refine_requirement を呼び出して要件を分解し、レイヤーごとのニーズを指定して get_stack を呼び出します。すると、スタック全体でどのバージョン同士が連携するかを示すバージョン互換性マトリックス付きで、3～5 個のツールで構成されたスタック（ウェブフレームワーク＋データベース＋認証＋決済）を取得できます。

選択肢を比較する

「REST API には Express と Fastify のどちらがよいですか？」 → compare_tools は、健全性を左右に並べて比較（スター数、メンテナンススコア、最終コミット、未解決の Issue、コントリビューターの推移）し、グラフ上の関係（それぞれが連携するものや置き換えるもの）と、提示されたユースケースに基づく推奨を返します。

バージョンの互換性を確認する

「React 17 のまま Next.js を 14 にアップグレードしたいです」 → check_compatibility は宣言されたピア依存のバージョン範囲を評価し、チェック結果（満たす／満たさない）とそのソース（declared_dependency／graph_edges／shared_neighbors）を返します。

プロジェクトのツールを追跡する

初回セッションでは、toolcairn_init がリポジトリを走査し、すべてのマニフェスト（package.json、requirements.txt、pyproject.toml、Cargo.toml、go.mod、pom.xml、Gemfile、composer.json、…）を解析して、各ツールを ToolCairn グラフに照らして分類し、ローカルの .toolcairn/ スナップショットを書き込みます。以降のセッションでは、このスナップショットを最初に読み込むため、エージェントはすでに把握している情報を再検索しなくなります。

---

利用可能なツール

MCP サーバーは、目的別に分類された 16 個のツールを公開しています。多くのツールはローカルで動作する（ネットワーク接続不要）か、実行後すぐに応答を返します。検索、比較、スタック関連のツールは ToolCairn API を呼び出します。

探索

ツール	機能
search_tools	健全性のシグナルや代替案を含む、自然言語による検索です。意図が曖昧な場合は、確認の質問をすることがあります。
search_tools_respond	進行中の検索を絞り込むための回答を送信します。
refine_requirement	曖昧なユースケース（「SaaS を構築する」など）を、具体的で検索可能なサブニーズに分解します。
verify_suggestion	エージェントが選んだツールが ToolCairn グラフに実際にインデックスされているか確認します。

スタックと互換性

ツール	機能
get_stack	バージョンをまたいだ互換性マトリックス付きで、相互に補完するツールのスタックを構成します。
compare_tools	複数のツールを直接比較し、健全性の指標、グラフ上の関係、推奨を提示します。
check_compatibility	2 つのツール間で、バージョンを考慮したピア依存の範囲チェックを行います。

プロジェクト設定

ツール	機能
toolcairn_init	プロジェクトルートを検出し、マニフェストをスキャンしてツールを分類し、.toolcairn/ に書き込みます。
read_project_config	ローカルの .toolcairn/config.json スナップショット（確認済みのツール、保留中の項目、監査ログ）を読み込みます。
update_project_config	ツールをアトミックに追加、削除、または更新します。変更はすべて監査ログに記録されます。

フィードバックループ

ツール	説明
report_outcome	実行して結果を待たない方式です。推奨されたツールがうまく機能したかを報告し、学習ループを完了させます。
feedback	ToolCairn 自体に対するエージェントからのフィードバックです。 ToolCairn の応答に誤りがあった場合、機能しなかった場合、品質が低かった場合、または何かを見落としていた場合にのみ呼び出してください。肯定的なフィードバックには使用しないでください。1 日あたりの割り当て量には含まれません。
suggest_graph_update	新しいツール、エッジ、またはユースケースを管理者のレビュー用に送信します（ステージングされ、自動昇格されることはありません）。
check_issue	最後の手段です。 既知のバグを確認するため、ツールの GitHub イシューを検索します。4 回以上再試行し、ドキュメントを確認した後にのみ使用してください。

セッション

ツール	説明
classify_prompt	ローカルで、ツール検索が必要かどうかを判断します（ツールに関係のないプロンプトでは ToolCairn をスキップします）。
toolcairn_auth	ローカルのサインインを管理します：login / status / logout。

---

設定

環境変数	デフォルト	用途
TOOLCAIRN_TRACKING_ENABLED	true	使用イベントのログ記録を無効にするには、false に設定します（プライバシーとテレメトリーを参照）。
LOG_LEVEL	info	詳細な stdio 診断を有効にするには、debug に設定します。
MCP_TRANSPORT	stdio	HTTP トランスポートを使用するには、http に設定します（上級者向け）。

ファイルの保存場所

• 認証情報 → ~/.toolcairn/credentials.json（モード 0600、有効期間は 90 日間）。
• プロジェクトごとの状態 → 検出された各プロジェクトルートの .toolcairn/{config.json, audit-log.jsonl, tracker.html}。

tracker.html ファイルは自己完結型のダッシュボードです。ブラウザーで開くと、すべてのツール呼び出し、保留中の評価、監査ログのエントリをリアルタイムで確認できます。

---

セッション管理

サインイン情報は ~/.toolcairn/credentials.json に保存され、有効期間は 90 日間です。エージェント内から次を実行します。

toolcairn_auth { action: "status" }   # check current sign-in
toolcairn_auth { action: "logout" }   # clear credentials

再認証するには、エージェントを再起動するだけです。サインインのフローが自動的に開始されます。

---

プライバシーとテレメトリー

お使いのマシンから送信される情報を明確にしています。

ToolCairn に送信される情報（トラッキングが有効な場合）：

• ツール名、所要時間、成功／エラーのステータス。サービスの稼働状況と製品分析に使用します。
• 送信されることはありません：プロンプト全文、応答本文、プロジェクトファイルの内容。

ローカルに保存される情報：

• すべての監査ログエントリ（.toolcairn/audit-log.jsonl）。
• プロジェクトの状態とツールのスナップショット。
• 認証情報ファイル。

いつでもオプトアウトできます：

TOOLCAIRN_TRACKING_ENABLED=false

ツールは引き続き通常どおり動作します。軽量な使用イベントのみがスキップされます。

プライバシーポリシー全文：toolcairn.neurynae.com/privacy。

---

トラブルシューティング

サインイン用のブラウザーが開かない場合。 stderr に出力された URL をコピーして手動で開き、表示されたデバイスコードを入力してください。

Module not found またはバージョンエラーが発生する場合。 Node 22 以降がインストールされていることを node --version で確認してください。

企業プロキシ経由で接続する場合。 HTTPS_PROXY を設定してください。npx と MCP サーバーはこの設定に従います。

セルフホストのバックエンドを使用する場合。 TOOLPILOT_API_URL=https://your-host を設定してください。

サインインの有効期限が切れた場合。 エージェントを再起動してください。デバイスコードのフローが自動的に再実行されます。

詳細なログを確認する場合。 LOG_LEVEL=debug を設定してください。

エージェントの動作を確認する場合。 ブラウザーで .toolcairn/tracker.html を開くと、すべてのツール呼び出しを自動更新するダッシュボードを確認できます。

---

CLI：scan

MCP サーバーを起動せずに、単独でヘルススキャンを実行します。

npx @neurynae/toolcairn-mcp scan [dir]

[dir]（デフォルト：カレントディレクトリ）にある依存関係マニフェスト、つまり package.json、requirements.txt、pyproject.toml、Cargo.toml を読み込み、宣言されている各依存関係の健全性、代替案、警告を報告します。

機械可読な出力を得るには、--json を追加してください。

---

リンク

• ウェブサイト： toolcairn.neurynae.com
• ドキュメント： toolcairn.neurynae.com/docs
• npm： @neurynae/toolcairn-mcp
• GitHub： neurynae/toolcairn-mcp
• イシュー： github.com/neurynae/toolcairn-mcp/issues
• セキュリティ： [email protected] への責任ある開示

---

コントリビューション

課題や機能リクエストは、github.com/neurynae/toolcairn-mcp/issues までお寄せください。

グラフエンジン、検索パイプライン、インデクサーはクローズドソースです。このリポジトリには、ユーザーのマシン上で動作する、公開された MCP クライアントとプロジェクト設定レイヤーが含まれています。

---

ライセンス

MIT — © 2026 NEURYNAE。LICENSE をご覧ください。