ZeroPath MCP Server

ZeroPath MCP サーバー

MCP 互換ツールを通じて、ZeroPath のセキュリティ検出結果を操作できます。

この MCP サーバーは ZeroPath の tRPC V2 プロシージャを直接呼び出し（REST ラッパーは使用しません）、エージェントでの利用に適した構造化 JSON レスポンスを返します。

---

ブログ記事

このサーバーを開発した理由と、進化する AI 開発エコシステムにおける位置付けについて、詳しくはこちらをご覧ください。

アプリケーションセキュリティのスキャン結果とチャットする：ZeroPath MCP サーバーのご紹介

インストール

クイックインストール（推奨）

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 入力オブジェクトを本文として送信します。

成功したレスポンスは、{ "result": { "data": ... } } のラッパーを取り除いた構造化 JSON として返されます。エラーの場合は、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 をご覧ください。