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 整合