pathguard

pathguard-mcp

PathGuard MCP を使用すると、MCP 互換の AI エージェントが会話中に暗号資産の取引をチェックし、詐欺やミスを検出できます。Claude Desktop、Claude Code、Gemini CLI、Grok CLI、Cursor、Codex などのローカル MCP クライアントに加え、リモートの Streamable HTTP デプロイにも対応しています。

公式 MCP Registry に org.cieltech.pathguard/pathguard として登録されています。

本番環境の MCP サーバーは、PathGuard の取引安全 API への、認証機能を備えた軽量なインターフェースです。PathGuard は送金前に取引を分析しますが、署名、ブロードキャスト、資金の移転は行いません。

本番環境の MCP

リモート Streamable HTTP エンドポイント：

https://pathguard-v2.up.railway.app/mcp/

リモートクライアントは OAuth を使って既存の PathGuard アカウントに接続します。認証時に、PathGuard はユーザーがすでに持っている API キーを検証します。API キーが AI クライアントに公開されたり、MCP 経由で返されたりすることはありません。

ローカル／stdio で使用する場合、PATHGUARD_API_KEY を通じてローカルサーバープロセスに API キーを渡します。

インストール

現在、このパッケージはこの公開リポジトリから直接インストールします。PyPI にはまだ公開されていません。

git clone https://github.com/Utee/pathguard-mcp.git
cd pathguard-mcp
python -m pip install .

開発時は、編集可能モードでインストールします。

python -m pip install -e .

Python 3.10+ および mcp >= 2.0 が必要です。

API キーの取得

PathGuard API documentation から PathGuard アカウントと API キーを作成します。

API キーは秘密にしてください。GitHub にコミットしたり、ブラウザー側のコードで公開したりしないでください。

ローカル MCP クライアント

ローカルクライアントでは、サーバーは stdio を使用し、PATHGUARD_API_KEY で PathGuard API に認証します。

Claude Desktop

Claude Desktop の設定に次を追加します。

{
  "mcpServers": {
    "pathguard": {
      "command": "pathguard-mcp",
      "env": {
        "PATHGUARD_API_KEY": "pg_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add --transport stdio pathguard -- pathguard-mcp

Claude Code を起動する環境で PATHGUARD_API_KEY を設定します。

Gemini CLI

{
  "mcpServers": {
    "pathguard": {
      "command": "pathguard-mcp",
      "env": {
        "PATHGUARD_API_KEY": "pg_your_key_here"
      }
    }
  }
}

Grok CLI

export PATHGUARD_API_KEY=pg_your_key_here
grok mcp add pathguard -- pathguard-mcp

Codex、Cursor、VS Code、その他のローカル MCP クライアント

Claude Desktop の例と同じ stdio サーバー定義を使用します。正確な設定場所はクライアントによって異なります。

リモートクライアント

リモートクライアントでは、上記の本番環境の OAuth 保護された Streamable HTTP エンドポイントを使用します。PathGuard API キーをブラウザー側の設定に含めないでください。

ChatGPT

Developer Mode が有効な ChatGPT ワークスペースでカスタム MCP アプリを作成し、次の情報を指定します。

https://pathguard-v2.up.railway.app/mcp/

OAuth 認証を選択します。ChatGPT は PathGuard の認証フローを使用して、既存の PathGuard アカウントに接続します。

認証フローでは、ユーザーの PathGuard API キーを検証した後、MCP 接続用の OAuth 認証情報を発行します。PathGuard API キーそのものが ChatGPT に返されることはありません。

利用可能なツール

ツール	機能
check_transaction	PathGuard のリスクシグナルを確認するため、暗号資産の送金先と任意の金額を検査します。
preflight_transaction	送金前の完全なチェックを実行し、ALLOW、REVIEW、または BLOCK を返します。
check_transactions_batch	最大 1,000 件の取引をチェックし、簡潔なリスク概要または詳細な結果を返します。
report_scam_address	ユーザーから明示的に報告を依頼された場合に、詐欺の疑いがあるアドレスを記録します。
get_usage_status	接続されたアカウントのプランと月間スキャン使用量を確認します。
get_profile	OAuth 接続で使用されている PathGuard アカウントを特定します。

ツールの安全境界

PathGuard MCP は分析専用です。ツールは次の操作を行いません。

• 取引への署名
• 取引のブロードキャスト
• 資金の移転
• 秘密鍵やシードフレーズの要求
• アプリケーションの認可制御の代替

BLOCK の結果は、PathGuard による安全性シグナルです。認可、署名、最終的な取引の実行については、引き続きウォレット、アプリケーション、またはエージェントが責任を負います。

バッチチェック

check_transactions_batch は最大 1,000 件の項目に対応しています。

デフォルトでは、以下を含む簡潔な概要を返します。

• 項目の合計数；
• 処理済み項目数；
• ALLOW／REVIEW／BLOCK の件数；
• 最大リスクスコア；
• フラグの件数；
• フラグが付いた取引のサンプル。

個別の結果が必要な場合は、detail_level="full" を使用してください。

セキュリティ

• API キーはサーバー側で管理し、非公開にしてください。
• リモート環境にデプロイする場合は HTTPS を使用してください。
• 本番環境のリモート MCP 接続は OAuth で保護されています。
• 本番環境の MCP サーバーは、認証済み OAuth サブジェクトを既存の PathGuard アカウントに紐付けます。
• サーバー間の内部認証は、MCP の引数やモデルから確認できる認証情報として公開されません。
• API キー、本番環境の認証情報、ローカルの .env ファイルは、決してコミットしないでください。

API リファレンス全文

エンドポイントのスキーマ、レート制限、料金、リスクフラグに関する情報は、PathGuard API ドキュメントを参照してください。

PathGuard MCP: https://pathguard.cieltech.org/mcp