pathguard-mcp

PathGuard を使うと、MCP互換のAIエージェントが会話の中で直接、暗号通貨取引の詐欺やミスをチェックできます。Claude Desktop、Claude Core、Gemini CLI、Grok CLI、Cursor、Codex などのローカルMCPクラエントに加え、ChatGPT と Grok web のコネクタ用のリ・モート Streamable HTTP デプロイにも対応しています。

Free（無料）を含む全プランで利用できます。これは、本プロセスが提供する他のツールと同じ、認証済みのAPIエンドポイントーを呼び出スだけなので、既に保有しているAPIキーのクォータがそのまま適用されします。

インストール

pip install pathguard-mcp

（現在はまだPyPIに公開されていません。現時点では、このフォルダーから直接ソース・インストールしてください: pip install -e .）

mcp >= 2.0 が必要です。本ツールは現在のMCP。サーバーキットに対してビルドし、テストしたものです。古い FastMCP API のバージョンを使用している場合は、先にアップグレード（pip install --upgrade mcp）しないと動作しません。

APIキーの取得

APIキーをお持ちでない場合は、pathguard.cieltech.og/docs.htmlで無料サインアップしてください。

ローカルMCPクラエントの設定

このパッケージをクラエントが動す環境にインストールし、PathGuard の APIキーをサーバーに設定してください。以下の例では、インストール済みの pathguard-mcp コマンドを使用しています。PATH が通っていない場合は、実行ファイルの完全なパスに置き換えてください。

Claude For Desktop

Claude Desktop の設定（claude_desktop_config.njson）に次の内容を追加してください:

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

Claude Desktop を再起動すると、Claude が自動に PathGuard のツールにアクセスできるようになりました。

Claude Code

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

Claude Code を起動する環環境で PATHGUARD_API_KEY を設定してください。あるいは、Claude Code のMCP設設定を使用して、その変数を明示的に渡すできます。

Gemini CLI

ユーザー全体の設定に ~/.gemini/settings.json、プロジェクト内の設定に .gemini/settings.json に次のエントリを追加してください:

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

あるいは、キーをエクスポートした後、コマンドララインで追加:

export PATHGUARD_API_KEY=pg_your_key_here
gemini mcp add --scope user pathguard pathguard-mcp

Grok CLI

キーをエクスポートした後、ローカルの stdio サーバーを追加してください。

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

設定を手動で ~/.grok/config.toml に保存するには、以下を使用します:

[mcp_servers.pathguard]
command = "pathguard-mcp"
env = { PATHGUARD_API_KEY = "${PATHGUARD_API_KEY}" }

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

Claude Desktop の例と同ジの stdio サーバー定義を使用してください: コマンド pathguard-mcp、引数なし、PATHGUARD_API_KEY を環境変数として指定ます。設定ファイルの場所やUIはクライアントによって異なりますが、MCPサーバーの設定は同一です。

リモートクライアント（ChatGPT と Grok web）の設定

ChatGPT と Grok のブラウザベースのカスタムコネクタは、自分のコンピュータ上でコマンドを直接起動することができません。PathGuard MCP を Streamable HTTP でデプロイし、HTTPSの背後に置いてください。その上で、公開エンドポイントをコネクタのUIに入力してください。

ローカルまたはデプロイ環境でHTTPサーバーを起動します:

export PATHGUARD_API_KEY=pg_your_key_here
pathguard-mcp --transport streamable-http --host 0.0.0.0 --port 8000 \
  --allowed-host mcp.example.com

MCPエンドポイントは http://localhost:8000/mcp です。ChatGPT や Robots web の場合は、保護されたHTTPSのURL（例: https://mcp.example.com/mcp）として公開してください。ブラウザやレポジトリにAPIキーを晒さないでください。「h」によるホスト名を --allowed-host に渡すか（または PATHGUARD_MCP_ALLOWED_HOSTS=mcp.example.com を設定）ことで、その公開ドメイン経由のリクエストをサーバーが安全に受け付けられるようします。このサーバーの PathGuard の認証情報はサーバーサイドにあるため、デプロイ先の各インスタンスは、そのサーバーの PATHGUARD_API_KEY に紐づく PathGuard アカウントを表します。

ChatGPT

Developer Boss（開発者モード）が有効な ChatGPT ワークスペースで、カスタムMCPアプリを作成し、公開の https://.../mcp エンドポイントを指定して、ツールをスキャンし、ワークスペースに合った形で保存または公開してください。ChatGPT はリモートMCPサーバーにのみ接続でき、ローカルの stdio コマンドには接続できません。現在のプランの利用可否や設定方法は、OpenAI の Developer Mode and MCP apps guide を参照してください。

Grok web

grok.com/connectors で New Connector を選択し、次に Custom を選び、公開の https://.../mcp エンドポイントを入力してください。Grok はパブリックインターネットを介してそのサーバーへ到達できる必要があります。現在のコネクタの流れは xAI の custom MCP connector guide を確認してください。

デプロイに関する注意

• 新しいリモートデプロイでは Streamable HTTP を使用してください。これが現在のMCP HTTPトランスポートです。

• TLSはホスティングプラットフォームまたはリバースプロキシーで終端し、可能な場合はアクセスを信頼済みユーザーやゲートウェイに制限してください。サーバーは現在、設定済みの1つのAPIキーで PathGuard に認証します。個々のMCPユーザーの認証は行いません。

• PATHGUARD_MCP_TRANSPORT=streamable-http、PATHGUARD_MCP_HOST=0.0.0.0、PATHGUARD_MCP_PORT=8000、PATHGUARD_MCP_ALLOWED_HOSTS= mcp.example.com をコマンドライン引数の代わりに設定すると、デプロイ先のプラットフォームに合う場合があります。PATHGUARD_MCP_PORT が未設定のときは PORT も利用されます。

• デスクトップ・アンドCLIクライアントでデフォルトの stdio トランスポートを保持してください。

利用可能なツール

実際のデプロイなしでのローカルテスト

本番環境の代わりに、ローカルバックエンドを指定してください。

export PATHGUARD_API_KEY=pg_your_test_key
export PATHGUARD_API_BASE=http://localhost:8000
pathguard-mcp

完全なAPIリファレンス

完全なエンドポイントのドキュメント、レート制限、フラグの意味については、pathguard.cieltech.org/docs.html を参照してください。このMCPサーバーは、その同一APIへのシンプルなラッパーです。