Openapi Scout Mcp

io.github.mrfentmen由 GitHub 帳號 mrfentmen 發布v1.0.2更新於 Nov 1, 2026

Local read-only OpenAPI and Swagger inspection with secret-safe schema summaries. Tools include...

已驗證STDIO僅桌面知識與記憶開發者工具

概覽

AI 產生的概覽

本機唯讀 MCP 伺服器，用來彙整本機的 OpenAPI 或 Swagger JSON 檔案，讓助理在寫程式前理解 API 契約。

可以做什麼
  • 彙整規格的版本、標題、伺服器與操作清單
  • 依 operationId 檢視單一操作
  • 列出元件 schema 或 Swagger definitions
  • 在結果中遮蔽範例、預設值、安全機制與類似憑證的鍵
適用情境
當磁碟上有 OpenAPI 或 Swagger JSON 檔案，希望助理在撰寫用戶端、測試、mock 或文件之前說明其端點與資料結構時使用。
執行需求
以本機 stdio 程序執行，從 npm 套件 openapi-scout-mcp 安裝（需 Node.js，於本機構建並執行）。規格必須是本機 JSON 檔案且不超過 2 MB；不需要網路、帳號或 API 金鑰。
安裝前請注意
僅供唯讀檢視，並非完整的 OpenAPI 驗證器或安全掃描器；不支援 YAML，需先轉成 JSON。只接受本機 JSON 檔案，不會抓取 URL。輸出中的敏感欄位會被遮蔽，但規格檔案本身仍會從本機讀取。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Openapi Scout Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

openapi-scout-mcp

A local-only MCP tool for quickly understanding an OpenAPI or Swagger JSON contract before writing clients, tests, mocks, or documentation.

Tools

  • inspect_spec: summarize version, title, servers, and operations.
  • find_operation: inspect one operation by operationId.
  • list_schemas: list component schemas or Swagger definitions.

Safety boundaries:

  • Only local JSON files are accepted. URLs and network fetches are not supported.
  • Files are capped at 2 MB and results are bounded.
  • Examples, defaults, security schemes, and credential-like keys are redacted.
  • YAML is not parsed in this release. Convert it to JSON first.

This is an inspection aid, not a complete OpenAPI validator or security scanner.

Run

bash
npm installnpm run buildnode dist/index.js

來源：README.md，提交 375a358

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

2
  1. v1.0.2最新Oct 2, 2026
  2. v1.0.0Sep 22, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。