ZeroPath MCP Server

ZeroPath MCP Server

通过兼容 MCP 的工具与 ZeroPath 安全发现交互。

此 MCP 服务直接调用 ZeroPath tRPC V2 程序（不使用 REST 封装），并返回适合 Agent 使用的结构化 JSON 响应。

---

博客文章

了解我们构建此服务的原因，以及它如何融入不断发展的 AI 开发生态：

与你的应用安全扫描对话：介绍 ZeroPath MCP Server

安装

快速安装（推荐）

直接从 GitHub 安装：

# Using pip
pip install git+https://github.com/ZeroPathAI/zeropath-mcp-server.git

# Using uvx (run without installing)
uvx --from git+https://github.com/ZeroPathAI/zeropath-mcp-server zeropath-mcp-server

你也可以固定到特定版本：

# Specific version tag
pip install git+https://github.com/ZeroPathAI/[email protected]

# Latest from main branch
uvx --from "git+https://github.com/ZeroPathAI/zeropath-mcp-server@main" zeropath-mcp-server

从源代码安装

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

从 PyPI 安装（可选）

如果该软件包已发布到 PyPI，你也可以通过以下方式安装：

pip install zeropath-mcp-server

---

设置

1. 生成 API 密钥

在 ZeroPath 设置中生成用户范围或管理员 API 密钥。

2. 配置环境变量

export ZEROPATH_BASE_URL="https://zeropath.com"  # optional (defaults to https://zeropath.com)
export ZEROPATH_TOKEN_ID=your_token_id
export ZEROPATH_TOKEN_SECRET=your_token_secret
export ZEROPATH_ORG_ID=your_org_id

使用 ZEROPATH_BASE_URL 指向暂存环境或其他环境，例如：

export ZEROPATH_BASE_URL="https://staging.branch.zeropath.com"

---

配置

将以下内容添加到你的 MCP 配置文件中（Claude Desktop、Cursor 等）：

使用 GitHub URL（推荐）

{
  "mcpServers": {
    "zeropath": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/ZeroPathAI/zeropath-mcp-server",
        "zeropath-mcp-server"
      ],
      "env": {
        "ZEROPATH_BASE_URL": "https://zeropath.com",
        "ZEROPATH_TOKEN_ID": "your_token_id",
        "ZEROPATH_TOKEN_SECRET": "your_token_secret",
        "ZEROPATH_ORG_ID": "your_org_id"
      }
    }
  }
}

使用源代码安装

{
  "mcpServers": {
    "zeropath": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/path/to/zeropath-mcp-server",
        "python",
        "-m",
        "zeropath_mcp_server"
      ],
      "env": {
        "ZEROPATH_BASE_URL": "https://zeropath.com",
        "ZEROPATH_TOKEN_ID": "your_token_id",
        "ZEROPATH_TOKEN_SECRET": "your_token_secret",
        "ZEROPATH_ORG_ID": "your_org_id"
      }
    }
  }
}

使用 PyPI 安装（可选）

{
  "mcpServers": {
    "zeropath": {
      "command": "zeropath-mcp-server",
      "env": {
        "ZEROPATH_BASE_URL": "https://zeropath.com",
        "ZEROPATH_TOKEN_ID": "your_token_id",
        "ZEROPATH_TOKEN_SECRET": "your_token_secret",
        "ZEROPATH_ORG_ID": "your_org_id"
      }
    }
  }
}

---

工具接口（tRPC V2）

启动时会从 ZeroPath 前端的 MCP 清单动态加载工具。

所有工具调用都使用 tRPC v10 HTTP 约定直接调用 tRPC V2 程序：

• 查询：GET /trpc/<procedure>?input=<url-encoded-json>
• 变更：POST /trpc/<procedure>，请求正文为原始 JSON 输入对象（不进行封装）。

成功响应会以结构化 JSON 的形式返回，并移除 { "result": { "data": ... } } 封装。错误会直接返回 tRPC error 对象。

此服务还会使用清单中的各工具 inputSchema 尽力执行客户端输入验证；如果输入无效，会在调用 tRPC 前返回 BAD_REQUEST 错误。如果架构使用了不受支持的 JSON Schema 功能，则会跳过该次调用的客户端验证（服务端验证仍具有权威性）。

---

调用示例

列出问题：

{
  "tool": "issues.list",
  "input": {
    "page": 1,
    "pageSize": 25,
    "statuses": ["PENDING_REVIEW"],
    "sortBy": "score",
    "sortOrder": "desc"
  }
}

归档问题：

{
  "tool": "issues.archive",
  "input": {
    "issueIds": ["issue_123", "issue_456"],
    "reason": "Confirmed duplicate"
  }
}

创建规则：

{
  "tool": "rules.create",
  "input": {
    "name": "Detect unsafe eval",
    "rule": "Detect any use of eval() on user input",
    "globPattern": "**/*.js",
    "sourceTypes": ["FILE_HANDLER"],
    "repositoryIds": ["repo_123"]
  }
}

获取统计摘要：

{
  "tool": "stats.summary",
  "input": {
    "organizationId": "org_123"
  }
}

---

开发

运行测试

uv run pytest tests/ -v

构建软件包

uv build

发布到 PyPI（可选）

uv publish

---

贡献

我们欢迎来自安全、AI 和开发者工具社区的贡献。

• 发现了错误？提交问题
• 想改进工具或添加新工具？提交拉取请求
• 有反馈或疑问？加入我们的 Discord

---

许可证

MIT 许可证——详情请参阅 LICENSE。