pathguard

pathguard-mcp

PathGuard MCP 让兼容 MCP 的 AI Agent 可以直接在对话中检查加密货币交易是否存在诈骗和错误。它支持 Claude Desktop、Claude Code、Gemini CLI、Grok CLI、Cursor 和 Codex 等本地 MCP 客户端，以及远程 Streamable HTTP 部署。

已列入官方 MCP 注册表，条目为 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 用法，API 密钥通过 PATHGUARD_API_KEY 提供给本地服务进程。

安装

目前，该软件包直接从此公开仓库安装，尚未发布到 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 文档创建 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 的安全信号。钱包、应用程序或 Agent 仍需负责授权、签名和最终交易执行。

批量检查

check_transactions_batch 最多支持 1,000 个项目。

默认情况下，它会返回精简摘要，其中包含：

• 项目总数；
• 已处理的项目数；
• ALLOW / REVIEW / BLOCK 的数量；
• 最高风险评分；
• 标记数量；
• 部分已标记的交易。

需要单项结果时，请使用 detail_level="full"。

安全

• 将 API 密钥保存在服务器端并妥善保密。
• 远程部署时使用 HTTPS。
• OAuth 保护生产环境中的远程 MCP 连接。
• 生产环境中的 MCP 服务会将经过身份验证的 OAuth 主体映射到现有的 PathGuard 账户。
• 内部服务器间身份验证不会作为 MCP 参数或模型可见的凭据公开。
• 切勿提交 API 密钥、生产凭据或本地 .env 文件。

完整 API 参考

请参阅 PathGuard API 文档，了解端点架构、速率限制、定价和风险标记信息。

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