XGR.Network MCP

XGR MCP 网关

XGR MCP 网关 通过 Model Context Protocol 为 XGR.Network 技术栈提供 AI 原生访问能力。它将 Claude、ChatGPT、IDE 助手和自定义宿主等兼容 MCP 的 Agent 连接到 XGRChain、XDaLa 会话、Explorer 数据、XRC 标准，以及经所有者审核的链上操作准备流程。

该网关专为 Agent 辅助工作流创建而设计：Agent 可以检查实时链上证据、分析 XDaLa 流程状态、起草 XRC 工件，并准备由用户审核并在本地签名的交接内容。

该网关绝不会请求、接收、存储或控制用户或第三方的私钥，也无法代表用户签名。用户的写入意图会被整理成交接内容，并在本地签名。可选的启动 Gas 服务可能会使用专用的服务器控制资金密钥，仅从服务钱包发送固定数量的 XGR Gas 赠款。

公共 MCP 端点

主网：

https://mcp.xgr.network/mcp

测试网：

https://mcp.testnet.xgr.network/mcp

使用主网检查真实的 XGRChain 和 XDaLa 活动。使用测试网，在投入生产使用前安全地起草、验证和试验由 Agent 驱动的工作流。

MCP 客户端配置

{
  "mcpServers": {
    "xgr-mainnet": {
      "type": "streamable-http",
      "url": "https://mcp.xgr.network/mcp"
    },
    "xgr-testnet": {
      "type": "streamable-http",
      "url": "https://mcp.testnet.xgr.network/mcp"
    }
  }
}

对于仍要求使用 http 而不是 streamable-http 的客户端，请使用相同的端点 URL，并选择客户端提供的 HTTP/远程 MCP 传输方式。

Agent 可以执行的操作

• 读取链状态：检查实时 XGRChain 状态、区块、账户状态和交易证据。
• 发现官方 XGR 资源：使用 get_xgr_network_info 获取规范的 XGR.Network、XGRChain、XDaLa、RPC、Explorer、MCP、文档和生态系统元数据。
• 检查 XDaLa 会话：查找、列出并说明会话、流程步骤、负载、回执和执行结果。
• 搜索 Explorer 数据：查询账户历史记录、价值转移、区块历史记录、交易统计信息和会话分析数据。
• 使用 XRC 标准：探索 XRC-137 规则、XRC-729 编排、流程图、复用模式和故障分析数据。
• 起草流程工件：根据内置架构和验证规则准备 XRC-137/XRC-729 工件和捆绑包。
• 准备由所有者签名的操作：为部署和会话启动创建审核并签名的交接内容，而不暴露私钥。
• 在启用时申请启动 Gas：在部署、会话启动、合约调用或其他链上操作前，向符合条件的低余额地址发放一笔固定的 1 XGR 赠款。

官方网络元数据

get_xgr_network_info 会返回 XGR.Network 及其生态系统的带版本、机器可读元数据。用户请求官方项目信息、网络配置、RPC 或 Explorer 端点、MCP 连接详情、文档、XRC 标准相关信息或源代码仓库时，Agent 应使用此工具。

get_chain_status 仍是实时 JSON-RPC 状态工具，并会额外返回所连接 XGRChain 主网的精简官方入口信息。

为什么选择 XGR.Network MCP

XGR.Network MCP 围绕确定性流程基础设施构建，而非通用聊天自动化。它为 Agent 提供对 XGR 技术栈的结构化访问，同时确保用户签名、用户托管和最终批准均在网关之外进行。

因此，它适用于：

• AI 辅助的 Web3 工作流设计
• XDaLa 流程准备与检查
• 面向合规的流程证据
• 确定性验证和执行流程
• 兼容 EVM 的流程自动化
• 用于访问 XGRChain 数据和 XRC 标准的 Agent 接口

文档

完整参考文档位于 XGR 中央文档站点：

• 网关概览
• 工具参考
• 操作交接
• 编写与知识
• 安装与配置

自托管

该网关可连接到你自己的 XGRChain RPC 和 Explorer 实例运行。自托管需要部署 Explorer，并配备只读 Postgres 镜像，以供交易搜索和会话分析工具使用。

典型设置流程：

npm install
npm run typecheck
npm run build
npm run start:http

所需的运行时配置见设置与配置。

安全模型

• 网关绝不会请求、接收、存储或控制用户或第三方的私钥。
• 用户交易会准备为交接内容，并由用户或用户的托管方案在本地签名。
• 可选的入门 Gas 服务是一个范围有限的例外：它只会为专用的服务器控制资金钱包中的转账签名，不能代表用户签名。
• 入门 Gas 补助固定为 1 XGR，并受收款方余额、每个地址仅可获得一笔已确认补助、每小时和每日上限以及有限重试策略的约束。
• 入门 Gas 补助状态使用 SQLite 原子存储，状态包括 reserved、broadcast、confirmed 和 failed。
• 生产环境中的用户签名仍由用户的钱包或托管方案控制。

链接

• 网站：https://xgr.network
• MCP 端点：https://mcp.xgr.network/mcp
• 官方 MCP Registry 名称：io.github.xgr-network/xdala-workflow-builder
• Smithery 列表：https://smithery.ai/servers/xgrnetwork/xdala-workflow-builder

许可证

根据 Apache License 2.0 授权。

Mainnet XGR 购买工具

可选的购买工具仅限主网，默认禁用，且 testnet 永远不会注册这些工具。只有在设置 XGR_PURCHASE_TOOLS_ENABLED=true、XGR_PURCHASE_NETWORK=mainnet，并提供有效的 HTTPS API URL（或本地 HTTP），且最高金额不超过 249.99 EUR 时，才启用这些工具。

quote_xgr_purchase 仅用于可选的规划。create_xgr_purchase_order 会通过一次 POST /api/orders 调用创建真实订单；网站确认弹窗不是单独的 API 阶段。后端负责确定最终价格、加密货币金额、托管钱包、付款参考信息和预留。MCP 不持有用户或第三方的私钥，也不会付款；外部钱包 Agent 可按返回的精确付款说明执行付款。

249.99 EUR 的上限是 MCP 对自主订单设定的策略限制。XGR_Web 后端另有要求：如果新计算出的 net_eur >= 250，则必须提供完整的账单地址；这并非后端订单上限。后端返回重新定价或地址错误时，不会重试订单。

购买工具会区分固定 XGR 订单和保守的 USDC/USDT 预算订单。实时后端 POST 决定具有约束力的市场价格和精确的 amount_crypto；EUR 仅作为策略／参考值。若预算订单返回的精确金额超出上限，则不会付款，现有预留会按正常流程过期。

入门 Gas 工具

启用后，get_xgr_starter_gas_options 会公开当前的固定补助和资格政策。request_xgr_starter_gas 会从专用服务钱包向符合条件、余额较低的 EVM 地址发送一笔固定的 1 XGR 补助。如果目标地址没有用于支付 Gas 的原生 XGR，Agent 应在部署、启动会话、调用合约或执行其他链上操作前使用该工具。

该服务不会要求地址所有权证明，也不会使用工作量证明。防滥用措施包括每个地址仅可获得一笔已确认补助、每小时和每日上限、收款方余额资格要求、服务钱包余额较低，以及广播前失败时有限的重试次数。