mcpField
N
Need

Need

本地服务
github.com/tuckerschreiber开发工具1032 周前更新
代码仓库

关于 Need

need 是为 AI Agent 和开发者提供的 CLI 工具发现服务，通过语义搜索查找已验证的工具，并根据安装反馈调整排名。它同时提供 MCP 服务和独立命令行界面。

主要功能

  1. 01语义搜索 CLI 工具
  2. 02索引超过 10,000 种工具
  3. 03安装匹配的工具
  4. 04依据使用反馈调整排名
  5. 05通过允许列表限制安装来源
  6. 06提供独立命令行界面

适用场景

  1. 01查找压缩 PNG 的命令行工具
  2. 02为文件转换任务发现 CLI 工具
  3. 03让 Agent 安装并使用匹配工具
  4. 04依据安装成败改善后续搜索

MCP 相关

MCP 服务提供搜索、安装和使用反馈三个工具；Agent 可据此完成发现、安装、使用并反馈的流程。

#cli#mcp#tool-discovery#ai-agents#semantic-search

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "need": {
      "command": "npx",
      "args": [
        "-y",
        "@agentneeds/need"
      ]
    }
  }
}
启动命令npx -y @agentneeds/need

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@agentneeds/need

工具

3

收录的工具列表 · 更新于 3 周前

参数类型必填说明
querystring是需要该工具执行的操作，用通俗英语描述
limitnumber否返回结果的最大数量

详细介绍

need

为 AI Agent 发现工具。

CI npm 版本 许可证 下载量

AI Agent 会臆造软件包名称。need 为它们提供经过验证的索引，收录了 10,000 多种 CLI 工具，并建立了一个封闭反馈循环，让每次安装都能让它变得更智能。

need 在 Claude Code 中的运行效果

使用场景

你让 Claude“压缩这些 PNG”。Claude 没有安装 pngquant，也不知道哪个工具最合适。但 need 正在后台作为 MCP 服务运行，因此 Claude 会自动：

  1. 搜索 need，查找“压缩 PNG 图片”
  2. 安装排名最高的结果（brew install pngquant）
  3. 运行该工具处理你的文件
  4. 报告运行成功，让下一位 Agent 搜索时将 pngquant 排得更靠前

你无需直接与 need 交互，只需查看结果即可。

  search → install → use → report
    ↑                        |
    └────── rankings ────────┘

安装

npm install -g @agentneeds/need

就这么简单。安装后，MCP 服务会自动为 Claude Code、Cursor 和 Claude Desktop 配置。你的 AI Agent 可以立即发现并安装 CLI 工具，无需你进行任何操作。

也可以立即试用，无需安装：npx @agentneeds/need "compress png images"

Agent 如何使用

在底层，need 提供了三个 MCP 工具，供 Agent 自主调用：

  1. search_tools — 在 10,000 多种 CLI 工具中进行语义搜索
  2. install_tool — 安装最匹配的工具（安全许可名单仅允许 brew、apt、npm、pip 和 cargo）
  3. report_tool_usage — 报告成功或失败，改善后续每位 Agent 的搜索排名

无需 API 密钥、账户或配置。Agent 会在无需离开编辑器的情况下完成整个流程。

也适用于用户

need 也可以作为独立 CLI 使用，支持理解意图而不只是关键词的语义搜索。

need convert pdf to png
need find duplicate files
need compress video without losing quality

工作原理

查询会通过 OpenAI 的 text-embedding-3-small 转换为嵌入向量，并与 pgvector 数据库中的 CLI 工具进行匹配。结果排名综合考虑语义相似度，以及来自 report_tool_usage 的社区成功或失败信号。

浏览工具

在 agentneeds.dev 浏览所有 10,000 多种已编入索引的工具。

架构

软件包描述
cli/need CLI 和 MCP 服务（npm）
api/搜索 API — Cloudflare Workers + Neon Postgres + pgvector
site/营销网站和工具目录（agentneeds.dev）

参与贡献

git clone https://github.com/tuckerschreiber/need.git
cd need
npm install
cd cli && npm run build && npm test

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。