forage

Forage は、AI エージェントが新しいツールを自動的に見つけ、インストールし、使い方を学習できるようにする MCP サーバーです。エージェントが行き詰まると、適切なツールを探し出してインストールし、自ら使い方を学びます。再起動も、手動での設定も不要です。エージェントは使うほど賢くなります。

なぜ Forage なのか？

AI コーディングエージェントは、セッション開始時に設定されているツールしか利用できません。データベースへのクエリが必要ですか？Vercel へのデプロイが必要ですか？Slack の検索が必要ですか？エージェントは対応できないと伝え、適切な MCP サーバーを手動でインストールすることになります。

Forage はこの課題を解決します。

Agent encounters a task it can't do
  → forage_search("query postgres database")
  → forage_install("@modelcontextprotocol/server-postgres")
  → Tools available IMMEDIATELY (no restart)
  → forage_learn() saves instructions to CLAUDE.md
  → Next session: auto-starts, agent already knows how to use it

クイックスタート

Claude Code

claude mcp add forage -- npx -y forage-mcp

Cursor

npx forage-mcp init --client cursor

これで完了です。新しいセッションを開始すれば、Forage を使えます。

ツール

仕組み

Forage は ゲートウェイ／プロキシ MCP サーバーです。

1. Forage を一度だけインストールします — 手動で設定する MCP サーバーはこれだけです
2. Forage がツールを検索します — Official MCP Registry、Smithery、npm を並行して検索します
3. Forage がツールをインストールします — 子プロセスとして起動し、その機能をラップします
4. 再起動は不要です — list_changed 通知を送信するため、エージェントは新しいツールをすぐに認識できます
5. 知識は保持されます — forage_learn がエージェントのルールファイルに書き込み、マニフェストが次のセッションでツールを自動起動します

┌─────────────────────────────────────────────┐
│  Claude Code / Cursor / Codex               │
│                                             │
│  "I need to query a Postgres database"      │
└──────────────────┬──────────────────────────┘
                   │ MCP
                   ▼
┌─────────────────────────────────────────────┐
│  Forage MCP Server                          │
│                                             │
│  forage_search ─── Official Registry        │
│  forage_install    Smithery                 │
│  forage_learn      npm                      │
│  forage_status                              │
│                                             │
│  ┌─────────────┐  ┌─────────────┐          │
│  │ Postgres MCP│  │ GitHub MCP  │  ...      │
│  │ (subprocess)│  │ (subprocess)│          │
│  └─────────────┘  └─────────────┘          │
└─────────────────────────────────────────────┘

CLI

Forage には、人間向けの CLI も含まれています。

forage search "postgres database"    # Search registries
forage list                          # List installed tools
forage init                          # Set up for Claude Code
forage init --client cursor          # Set up for Cursor

セキュリティ

重要

明示的なユーザー承認がない限り、Forage がツールをインストールすることはありません。すべての forage_install 呼び出しには confirm: true が必要です。

• 監査ログ — すべてのインストール／アンインストールが、タイムスタンプ付きで ~/.forage/install-log.json に記録されます
• リモートバックエンドなし — すべてローカルで実行されます。レジストリ検索は公開 API への読み取り専用 GET リクエストです
• シークレットは保存されません — 子サーバーの環境変数はインストール時に渡され、永続化されません

開発

git clone https://github.com/isaac-levine/forage.git
cd forage
npm install
npm run build

Claude Code でローカルにテストします。

claude mcp add forage-dev -- node /path/to/forage/dist/server.js

詳細については、CONTRIBUTING.md をご覧ください。

ロードマップ

機能

• forage update — インストール済みツールの新しいバージョンを確認します
• pip/cargo/brew パッケージに対応します（npm だけでなく）
• 検索順位を改善します（ダウンロード数、スター数、説明文との関連性で重み付けします）
• .env ファイルから環境変数を自動設定します
• forage doctor — よくあるセットアップの問題を診断します

配布

• npm に公開します
• Official MCP Registry に申請します
• Smithery に申請します
• mcp.so と glama.ai に申請します
• forage.dev のランディングページ

コミュニティ

• README にデモ GIF／動画を追加します
• リリース告知ブログ記事を執筆します
• r/ClaudeAI、r/LocalLLaMA、Hacker News（Show HN）に投稿します
• MCP Discord／コミュニティチャンネルで共有します
• ユースケースガイドを執筆します（例：「Claude Code に Postgres を 30 秒で追加する」）
• Q&A と機能リクエスト用に GitHub Discussions を追加します

ライセンス

MIT