Zeropath MCP Server

🚀 零路徑MCP服務器

零路徑MCP服務器允許開發者藉助自然語言與產品安全漏洞進行交互，可直接從ZeroPath查詢SAST問題、秘密、補丁等信息，並在Claude Desktop、Cursor、Windsurf等兼容的MCP環境中的AI輔助工具裡使用，無需儀表盤和手動票務分類，在工作時就能獲取安全上下文。

🚀 快速開始

零路徑MCP服務器能讓您在工作場景中便捷地獲取安全信息。您可以通過以下步驟進行安裝和配置，從而在項目中集成並利用其功能。

✨ 主要特性

• 自然語言交互：支持通過自然語言與產品安全漏洞進行交互。
• 信息查詢便捷：可直接從ZeroPath查詢SAST問題、秘密、補丁等信息。
• 多環境兼容：能在Claude Desktop、Cursor、Windsurf等兼容的MCP環境中的AI輔助工具裡使用。
• 無需額外操作：無需儀表盤和手動票務分類，在工作時即可獲取安全上下文。

📦 安裝指南

1. 生成API密鑰

從ZeroPath組織設置中的https://zeropath.com/app/settings/api生成一個API密鑰。

2. 配置環境變量

設置您的環境變量以包含API密鑰：

export ZEROPATH_TOKEN_ID=your_token_id
export ZEROPATH_TOKEN_SECRET=your_token_secret

3. 獲取組織ID

運行以下命令以獲取您的組織ID：

curl -X POST https://zeropath.com/api/v1/orgs/list \
    -H "X-ZeroPath-API-Token-Id: $ZEROPATH_TOKEN_ID" \
    -H "X-ZeroPath-API-Token-Secret: $ZEROPATH_TOKEN_SECRET" \
    -H "Content-Type: application/json" \
    -d '{}'

4. 安裝uv

我們使用uv進行依賴管理：

curl -LsSf https://astral.sh/uv/install.sh | sh

5. 克隆和設置

git clone https://github.com/ZeroPathAI/zeropath-mcp-server.git
cd zeropath-mcp-server
uv sync
export ZEROPATH_ORG_ID=your_org_id

📚 詳細文檔

配置

將以下條目添加到您的MCP配置（Claude Desktop、Cursor等）中：

{
  "mcpServers": {
    "zeropath-mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "<絕對克隆目錄路徑>/zeropath-mcp-server",
        "<絕對克隆目錄路徑>/zeropath-mcp-server/main.py"
      ]
    }
  }
}

將<絕對克隆目錄路徑>替換為倉庫的絕對路徑。

環境變量

在運行服務器之前，導出以下內容：

export ZEROPATH_TOKEN_ID=your_token_id
export ZEROPATH_TOKEN_SECRET=your_token_secret
export ZEROPATH_ORG_ID=your_org_id

這些可以從您的ZeroPath儀表盤中獲得。

可用工具

連接後，以下工具可供您的AI助手使用：

search_vulnerabilities(search_query: str)

通過關鍵字查詢SAST問題。 提示示例：

"顯示用戶服務中的所有SSRF漏洞。"

get_issue(issue_id: str)

獲取特定問題的完整元數據、補丁建議和代碼上下文。 提示示例：

"給我abc123問題的詳細信息。"

approve_patch(issue_id: str)

批准補丁（寫入操作）。這是一個示例，其中issue_id為example-123 提示示例：

"批准example-123問題的補丁。"

開發模式

在開發環境中運行時，請確保設置以下內容：

1. 克隆此倉庫
2. 安裝依賴項（請參閱INSTALL.md）
3. 啟動服務器（請參閱USAGE.md）

博客文章

瞭解我們構建此產品的更多原因及其如何適應不斷發展的AI開發生態系統： 📄 與您的應用安全掃描對話：介紹零路徑MCP服務器

🤝 貢獻

我們歡迎所有貢獻！請幫助我們改進文檔、修復錯誤或添加新功能。要報告問題或提出建議，請訪問我們的GitHub倉庫，或者加入我們的Discord社區進行交流。

通過遵循這些步驟，您可以在項目中集成並利用零路徑MCP服務器的功能。