forage

Forage 是一个 MCP 服务，可让 AI Agent 自动发现、安装并学习使用新工具。当 Agent 遇到难题时，它会自行寻找合适的工具、安装工具，并学会如何使用。无需重启，无需手动配置。Agent 会永久变得更聪明。

为什么选择 Forage？

AI 编码 Agent 的能力受限于会话开始时配置的工具。需要查询数据库？部署到 Vercel？搜索 Slack？Agent 只能道歉，然后由你手动安装合适的 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 通知，让 Agent 立即获取新工具
5. 知识持久保存——forage_learn 会写入 Agent 规则文件，清单会在下次会话中自动启动工具

┌─────────────────────────────────────────────┐
│  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 / 社区频道分享
• 撰写用例指南（例如“在 30 秒内为 Claude Code 添加 Postgres”）
• 添加 GitHub Discussions，用于问答和功能请求

许可证

MIT