dep-scout

dep-scout

先查再造 (先研究，再构建) —— 一个 MCP 服务，可防止 AI 编码 Agent 重复造轮子。

在 Agent 从头编写某项功能之前，dep-scout 会在合适的注册表中搜索——crates.io（Rust）、npm（JS/TS/前端）、PyPI（Python）、pkg.go.dev（Go）、Maven Central（Java/Kotlin）或 NuGet（.NET）——寻找已经解决该问题的成熟软件包，并根据复用质量（受欢迎程度、近期维护情况、版本稳定性、元数据）为每个候选项评分，同时标记已知安全公告（OSV）和许可证合规风险。随后，Agent 可以复用经过验证且安全的解决方案，而不是手写容易出错的代码。它还可以搜索官方 MCP 注册表，让 Agent 复用现有 MCP 服务，而不是从头构建。

可通过标准输入/输出与 Cursor（以及任何 MCP 客户端）配合使用。无需 API 密钥——所有数据源都是无需密钥的公共 API。

为什么要用

如今，AI 编写了大量代码——而它最糟糕的习惯，是重复实现已解决的问题、选择无人维护的库，或凭空捏造软件包。dep-scout 将“如果已有维护良好的软件包能解决问题，就不要从头构建”这一最佳实践转化为 Agent 可自动调用的工具，支持多种语言。

工具

工具	功能
find_packages	根据功能描述和 ecosystem（rust | npm | python | go | maven | nuget），返回已排序的候选项，包含 0–100 的复用评分、信号和警告。
inspect_package	根据准确的软件包名称和生态系统，深入检查单个软件包：许可证（含合规标记）、已知 OSV 漏洞、弃用/撤回状态、运行时/版本要求、下载量或 GitHub 星标，以及距离上次更新的时间。
find_mcp_servers	搜索官方 MCP 注册表中的现有 MCP 服务（名称、安装信息、仓库、状态），避免重复构建。

ecosystem 接受以下别名：js/ts/javascript/typescript/node/frontend → npm， py/pip → python，golang → go，java/kotlin/gradle/jvm → maven， dotnet/csharp/net → nuget，rs/cargo → rust。

复用评分（0–100）

• 受欢迎程度（≤40）——将下载量归一化到约 90 天的时间范围；对于 Go/Maven （没有公开下载统计），使用 GitHub 星标作为替代指标。
• 维护情况（≤30）——软件包最近一次更新距今的时间。
• 稳定性（≤15）——稳定的 1.0+ 与 0.x 版本之别；预发布版本会受到扣分。
• 元数据（≤15）——是否提供仓库、文档/主页和许可证。
• 安全扣分——已解析版本存在已知的 OSV 安全公告时，会降低评分并使候选项排名下降。
• 许可证标记——Copyleft / 商业使用受限许可证（GPL、AGPL、 LGPL、MPL、SSPL、BUSL……）会作为合规警告显示。
• 惩罚——最新版本已撤回（crates/PyPI）或已弃用（npm）。

评定结果：≥78 ✅ 强烈推荐 · 58–77 🟡 可以使用 · 38–57 🟠 谨慎使用 · <38 🔴 寻找替代方案。

排名综合考量文本相关性（查询词重合度、名称精确匹配）、复用评分和注册表自身的排序方式，确保结果既切合主题，质量也高。

数据源（均无需密钥）

生态系统	搜索	详情	热度
Rust	crates.io API（合并相关性和下载量）	crates.io API	crates.io 下载量（近 90 天）
npm	registry.npmjs.org/-/v1/search	registry.npmjs.org/{pkg}/latest	api.npmjs.org（上个月）
Python	deps.dev 名称搜索（+ token 回退）	pypi.org/pypi/{pkg}/json	pypistats（上个月）
Go	deps.dev 名称搜索	deps.dev v3（GetPackage/GetVersion/GetProject）	GitHub 星标数
Java/Kotlin	Maven Central solr 搜索	deps.dev v3	GitHub 星标数
.NET	NuGet 搜索 API	NuGet 搜索 API	NuGet 总下载量
MCP 服务	官方 registry.modelcontextprotocol.io	—	—
安全	OSV.dev query（详情）+ querybatch（标记），覆盖所有生态系统

Python 说明： PyPI 没有公开的全文搜索 API（旧版 XML-RPC 搜索已停用，网页搜索会屏蔽机器人），因此 Python 搜索通过 deps.dev 按名称进行。如果查询是库名称或包含库名称，效果很好；如果只是查询功能描述，建议使用已知名称调用 inspect_package。

构建

需要较新的 Rust 工具链（edition 2024）。

cargo build --release

生成的二进制文件位于 target/release/dep-scout（Windows 上为 .exe）。

在 Cursor 中使用

1. 注册 MCP 服务。可移植的项目配置位于 .cursor/mcp.json — 它使用 cargo run --release，因此无需 特定于机器的路径。如需全局使用，请在 ~/.cursor/mcp.json 中添加一项：

   {
     "mcpServers": {
       "dep-scout": {
         "command": "/absolute/path/to/dep-scout/target/release/dep-scout"
       }
     }
   }
   

   在 Windows 上使用 ...\\target\\release\\dep-scout.exe。使用直接二进制文件路径时， 请先构建发布版二进制文件（见上文的 cargo build --release）。

2. 重启 Cursor；你应该会看到 dep-scout，其工具已启用。

3. .cursor/rules/research-before-build.mdc 规则会让 Agent 在构建前先搜索。可移植且不依赖特定客户端的 版本位于 skill/SKILL.md。

通信方式

基于官方 rmcp SDK，通过 stdio 使用标准 MCP（JSON-RPC 2.0）。日志写入 stderr，因此不会 破坏 stdout 上的协议流。

路线图

• 支持更多生态系统：Ruby（RubyGems）、PHP（Packagist）、Dart/Flutter（pub.dev）。
• 针对各生态系统校准热度（npm/PyPI 的体量远超 crates.io）。
• NuGet 的最近更新情况；更丰富的 Maven 搜索排名。
• 更深入的仓库健康指标（未解决的问题、发布频率、维护者数量）。
• 精选的可信度/质量数据集 — 这是相较于普通注册表镜像的真正优势。

项目结构

src/
  main.rs      # MCP server + tools (find_packages / inspect_package / find_mcp_servers)
  model.rs     # Ecosystem enum, normalised Package, reuse scoring, relevance
  sources.rs   # keyless registry clients (crates.io, npm, PyPI, deps.dev, MCP registry)
.cursor/
  rules/research-before-build.mdc   # always-on Cursor rule
  mcp.json                          # local server registration
skill/SKILL.md                      # portable skill for any MCP client

MCP Registry

已作为 io.github.unievolver/dep-scout 发布到官方 MCP Registry。 从 GitHub Releases 下载 .mcpb 包，或使用 cargo build --release 从源代码构建。

• MCP Registry 名称：mcp-name: io.github.unievolver/dep-scout

许可证

MIT