OSS Audit (package due diligence)

io.github.santex85由 GitHub 账号 santex85 发布v0.1.0更新于 Nov 19, 2026

Open-source package due diligence: licences, release health, Scorecard, dependents, OSV vulns.

发布方自己的服务:audit.domains - Domain Valuation

已验证STDIO仅桌面开发者工具安全与监控

概览

AI 生成的概览

让助手核查 npm、PyPI、Go、Maven、Cargo 和 NuGet 开源包的许可证、发布活跃度、Scorecard 与已知漏洞。

可以做什么
  • 生成单个包版本的报告:许可证与 copyleft 类别、最新版本、发布新鲜度、依赖者数量、仓库数据、OpenSSF Scorecard 与 OSV 漏洞
  • 为最多 50 个包生成许可证表格,含 copyleft 标记与类别统计
  • 列出某个包或指定版本的 OSV 公告,按别名合并、按严重程度排序,并给出修复版本
  • 在同一生态内并排比较最多 10 个候选包,并指出各项指标最优的包
适用场景
适合在引入依赖之前、许可证审查过程中或技术尽职调查时使用,快速获得某包的许可证、维护活跃度和已知漏洞的有据可查的概况。
运行要求
以本地进程运行;README 说明需创建 Python 虚拟环境并安装 pip 依赖,可通过 stdio 或 streamable HTTP 启动。无需 API 密钥。需要访问 deps.dev 和 OSV.dev 接口的网络连接。可选环境变量 HOST、PORT 和 MCP_TRANSPORT 控制传输方式。
安装前请注意
会把包名和版本发送给 deps.dev 与 OSV.dev,返回结果带有 CC-BY 4.0 署名字段,再分发结果时应保留。许可证数据可能不完整或有误,漏洞结果为空只表示 OSV 没有相关公告;README 明确说明它不构成法律意见,也不是完整的安全审计。OSV 的使用条款未核实,商业使用前应自行确认。

安装

在 SourceWeft 中

  1. 打开 控制台中的 OSS Audit (package due diligence),将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

OSS Audit MCP server (open-source package due diligence)

An MCP server that lets AI agents vet open-source dependencies before adoption, in a licence review, or during technical due diligence. For npm, PyPI, Go, Maven, Cargo (crates.io) and NuGet it reports licences with copyleft classification, release recency, dependents count, the linked repository's OpenSSF Scorecard, and known vulnerabilities with severity and fixed versions. It reads deps.dev and OSV.dev live and needs no API key.

Not legal advice and not a full security audit. Licence data is detected from package metadata and can be incomplete or wrong (e.g. non-standard). A clean vulnerability result only means OSV has no advisory, not that the code is safe.

Tools

ToolWhat it does
package_reportOne package version: licence + copyleft category, latest version, release recency, releases in the last 12 months, dependents, repo stars/forks/issues, OpenSSF Scorecard (overall + checks), OSV vulnerabilities, red flags
check_licensesLicence table for up to 50 packages, with a copyleft flag (GPL/AGPL/LGPL/MPL/EPL and similar), category counts and per-row errors
vulnerabilitiesOSV advisories for a package, or for one exact version. Aliases are merged, items are sorted by severity, and each has fixed versions
compare_packagesSide-by-side health table for up to 10 alternatives in one ecosystem, plus the best package per metric

Example calls

jsonc
// package_report{"ecosystem": "npm", "name": "express"}//   -> 5.3.0, MIT (permissive), 115k dependents, repo 69.7k stars, Scorecard 8.5, 0 vulns, flags []{"ecosystem": "maven", "name": "org.apache.logging.log4j:log4j-core", "version": "2.14.1"}//   -> 8 advisories incl. 2 CRITICAL (Log4Shell), flag "not the default/latest version (2.25.5)"{"ecosystem": "go", "name": "github.com/gin-gonic/gin"}
// check_licenses (strings "ecosystem:name@version", version optional; or objects){"packages": ["npm:[email protected]", "pypi:requests", "maven:org.hibernate:[email protected]",              "go:github.com/gin-gonic/[email protected]", "cargo:serde", "nuget:[email protected]",              {"ecosystem": "pypi", "name": "PyQt5"}]}//   -> hibernate-core LGPL-2.1-or-later (weak-copyleft), PyQt5 GPL-3.0 (strong-copyleft), the rest permissive
// vulnerabilities{"ecosystem": "npm", "name": "lodash", "version": "4.17.15"}        // 5 advisories: 3 HIGH, 2 MEDIUM{"ecosystem": "pypi", "name": "django", "limit": 5, "include_details": true}   // all 160+ ever filed, top 5
// compare_packages{"ecosystem": "pypi", "names": ["requests", "httpx", "aiohttp", "[email protected]"]}{"ecosystem": "npm", "names": ["axios", "node-fetch", "got"]}

Package naming: npm express, @types/node; PyPI requests (case-insensitive); Go module path github.com/gin-gonic/gin; Maven groupId:artifactId; Cargo serde; NuGet Newtonsoft.Json. The ecosystem accepts aliases such as python, rust, crates.io, golang and dotnet.

Licence categories

permissive · weak-copyleft (LGPL, MPL, EPL, CDDL, …) · strong-copyleft (GPL, EUPL, OSL, CC-BY-SA, …) · network-copyleft (AGPL, SSPL) · other/proprietary (LicenseRef, BUSL, Elastic, CC-BY-NC) · unknown. An A OR B expression takes the least restrictive option and sets permissiveAlternative when a copyleft option is also offered. A AND B takes the most restrictive. copyleftFamilies lists GPL/AGPL/LGPL/MPL/EPL hits explicitly. Licence exceptions (WITH Classpath-exception-2.0) are not weighed, so review those by hand.

Severity

The GitHub advisory rating is used where OSV has one (MODERATE is shown as MEDIUM). Otherwise the server computes the CVSS v3.x base score from the vector. CVSS v4-only advisories without a rating show UNKNOWN. Advisories that alias each other (GHSA / PYSEC / CVE / GO / RUSTSEC) are merged into one entry, which keeps the GHSA record and lists the others in alsoKnownAs.

Limits and data caveats

  • "Latest version" is the registry default. When that default is a pre-release (e.g. 1.0.0.dev6), the newest stable release is used instead. latestReleaseAt is the newest publish of any version, including pre-releases. Go pseudo-versions (untagged commits) are excluded from version counts.
  • Dependents come from deps.dev's v3alpha :dependents endpoint. It can change, and it returns 0 or nothing for some ecosystems/packages (e.g. Cargo serde shows 0; Go and NuGet return none). A note is added when the count is 0.
  • Repository, stars and Scorecard depend on deps.dev linking a source repo. Older versions often lack the link, so the latest version's link is used as a fallback. Scorecard results are weekly snapshots.
  • vulnerabilities without a version follows up to 3 OSV result pages. truncatedUpstream is set if more exist.
  • Caps: 50 packages per check_licenses call, 10 per compare_packages call, 100 advisories returned, 6 concurrent upstream requests, 30 s HTTP timeout, 120 s per tool call, 12 MB per upstream response.

Data sources and attribution

  • deps.dev API v3 (Open Source Insights, Google), https://api.deps.dev. Its generated data is licensed CC-BY 4.0, so every response carries an attribution field. Keep it when you redistribute results. Attribution: "Package, licence, dependents and Scorecard data from deps.dev (Open Source Insights by Google), licensed CC-BY 4.0."
  • OSV.dev API v1, https://api.osv.dev. Advisory records are aggregated from upstream databases (GitHub Advisory Database, PyPA, Go, RustSec, …) under those sources' own licences. I did not check OSV's terms during this build. Check them before commercial use.
  • The User-Agent is oss-audit-mcp/0.1 (+MCP server; ...).

Run

bash
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt.venv/bin/python src/server.py                         # streamable-http on 0.0.0.0:8080, endpoint /mcpPORT=8097 .venv/bin/python src/server.py               # other portMCP_TRANSPORT=stdio .venv/bin/python src/server.py     # stdio, for local MCP clients.venv/bin/python tests/live_test.py                    # live smoke test of every tool

Environment variables: HOST (default 0.0.0.0), PORT (default 8080), MCP_TRANSPORT (streamable-http, stdio or sse; default streamable-http). No API key is needed.

mcpize.yaml describes the build and start commands for MCPize.

Use with Claude Desktop or another MCP client

Local (stdio). Clone the repo, create the venv as above, then add this to claude_desktop_config.json (or your client's MCP config), with the paths changed to where you cloned it:

json
{  "mcpServers": {    "oss-audit": {      "command": "/path/to/oss-audit-mcp/.venv/bin/python",      "args": ["/path/to/oss-audit-mcp/src/server.py"],      "env": {"MCP_TRANSPORT": "stdio"}    }  }}

Remote (streamable HTTP). Run .venv/bin/python src/server.py on a server and point any client that supports remote MCP servers at http://<host>:8080/mcp. GET /health returns {"status": "healthy"}.

License

MIT, see LICENSE. The data returned by the tools stays under the terms of its sources (see above).

来源:README.md,提交 6ea47df

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.1.0最新Nov 19, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Audit 集成