Yogosha MCP

🚀 Yogosha MCP 服務器

本項目在 Yogosha 漏洞賞金平臺和模型上下文協議（MCP）生態系統之間搭建了一座無縫橋樑。通過將所有 Yogosha API 端點作為 MCP 工具公開，它使安全團隊、自動化工程師和 AI 副駕駛（如 Claude Desktop）能夠以編程方式與 Yogosha 資源進行交互，而無需手動進行 API 調用或編寫自定義腳本。

🚀 快速開始

項目影響

• 自動化：使用自然語言或工作流工具，立即自動執行漏洞管理、資產清單、報告等任務。
• 集成：將 Yogosha 與任何兼容 MCP 的代理、大語言模型（LLM）或工作流編排器（如 Claude Desktop、自定義機器人）連接起來。
• 安全性：通過環境變量強制進行 API 密鑰管理，代碼中不包含任何機密信息。所有操作都是無狀態且可審計的。
• 可擴展性：只需擴展 server.py 即可添加新的端點或自定義邏輯，無需修改核心基礎設施。
• 提高生產力：顯著減少對漏洞和資產進行分類、更新或報告所需的時間。

解決的問題

• 手動 API 工作：無需為每個 Yogosha API 調用編寫自定義腳本，只需使用 MCP 工具界面。
• AI 副駕駛支持：讓大語言模型和自動化代理直接管理你的漏洞賞金計劃、資產和報告。
• 統一安全運營：使用 MCP 標準將 Yogosha 與其他安全工具和儀表盤集成。

📦 安裝指南

項目要求

• Python 3.8 及以上版本
• uv（用於快速 Python 包管理和運行）
• Yogosha API 密鑰

安裝步驟

1. 安裝依賴項：

   uv pip install -r requirements.txt
   

2. 設置 Yogosha API 密鑰：

   export YOGOSHA_API_KEY=your_yogosha_api_key_here
   

3. 運行 MCP 服務器：

   uv run server.py
   

   服務器默認使用標準輸入輸出傳輸，以便與 Claude Desktop 和其他 MCP 客戶端集成。

💻 使用示例

基礎用法

服務器啟動後，你可以使用 Claude Desktop 或任何 MCP 客戶端執行以下操作：

• 列出所有項目：list_programs()
• 創建新資產：create_asset(program_id, asset_data)
• 修復漏洞：patch_vulnerability(program_id, vulnerability_id, patch_data)

高級用法

在 Claude Desktop 中配置 MCP 服務器

要在 Claude Desktop 中使用此服務器，請將以下內容添加到你的 mcpserver.json 文件中：

{
  "mcpServers": {
    "YogoshaMCP": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/haji/mcp-servers/yogosha-mcp",
        "run",
        "server.py"
      ]
    }
  }
}

• 如果你的項目位於不同位置，請調整 --directory 路徑。
• 該服務器將在 Claude Desktop 中以 "YogoshaMCP" 的名稱可用。

🔧 技術細節

安全性

• API 密鑰從 YOGOSHA_API_KEY 環境變量中讀取。切勿將你的 API 密鑰提交到源代碼管理系統中。
• 所有代碼都設計為無狀態的，可安全用作 MCP 工具。

擴展性

• 要添加更多端點，只需遵循 server.py 中的函數模式。

📄 許可證

本項目採用 MIT 許可證，或遵循本倉庫中指定的許可證。