Yogosha Mcp

Yogosha MCP 服务

概述

本项目为 Yogosha Bug Bounty Platform 与 Model Context Protocol（MCP）生态系统提供无缝桥接。通过将所有 Yogosha API 端点公开为 MCP 工具，安全团队、自动化工程师和 AI 副驾驶（如 Claude Desktop）无需手动调用 API 或编写自定义脚本，即可通过编程方式与 Yogosha 资源交互。

影响

• 自动化： 使用自然语言或工作流工具，即时自动化漏洞管理、资产清单、报告等工作。
• 集成： 将 Yogosha 连接到任何兼容 MCP 的 Agent、大模型或工作流编排器（例如 Claude Desktop、自定义机器人）。
• 安全性： 通过环境变量管理 API 密钥；代码中不包含机密信息。所有操作均为无状态且可审计。
• 可扩展性： 只需扩展 server.py 即可添加新端点或自定义逻辑，无需修改核心基础设施。
• 效率： 大幅缩短漏洞和资产的分类、更新或报告所需时间。

解决哪些问题？

• 手动处理 API： 无需再为每次 Yogosha API 调用编写自定义脚本，只需使用 MCP 工具接口。
• 启用 AI 副驾驶： 让大模型和自动化 Agent 直接管理漏洞赏金计划、资产和报告。
• 统一安全运营： 使用 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
   

   默认情况下，服务使用 stdio 传输，以便与 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，或遵循此存储库中指定的许可证。