加密货币支付协议服务器

Modexia AgentPay MCP Server 是一个官方模型上下文协议(MCP)服务器,用于自主AI代理与Modexia的加密货币基础设施交互,提供程序化智能合约钱包功能。

  • by Modexia
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 Modexia/modexia-mcp

使用说明


名称:莫德夏mcp 版本:0.4.1 描述:用于自主AI代理与Modexia加密基础设施交互的官方模型上下文协议(MCP)服务器。 作者:莫德夏 主页:https://github.com/Modexia/ModexiaAgentpay 标签:

  • 主控程序
  • web3
  • 支付 头像:https://raw.githubusercontent.com/Modexia/ModexiaAgentpay/main/apps/mcp-server/assets/modexialogo.png 配置: 类型:stdio 命令:uvx args:
    • 莫德夏mcp 技能:
  • 纳米颗粒
  • 纳米活化剂
  • 纳米沉积
  • 纳米拉丝
  • 纳米平衡
  • 提交意图
  • 获取内容
  • list_内容
  • open_channel
  • 消费渠道
  • settle_channel
  • get_channel
  • list_channels
  • get_balance
  • 获取历史
  • 转移
  • 跨海转运
  • 智能蚀刻 提示:
  • nanopay_usage指令
  • create_intent_payment_指令
  • setup_microtransactions_指令
  • create_payment_指令 资源:
  • modexia://docs/llms_context

Modexia AgentPay MCP Server

The official Model Context Protocol (MCP) server for autonomous AI Agents to interact with Modexia's crypto infrastructure.

[![MCP Badge](https://lobehub.com/badge/mcp-full/modexia-modexia-mcp?theme=light)](https://lobehub.com/mcp/modexia-modexia-mcp)

欢迎来到 Modexia代理支付MCP服务器 (modexia-mcp).该服务器弥合了大型语言模型与现实世界数字经济之间的差距。

通过将此标准模型上下文协议(MCP)服务器集成到您的AI堆栈(Claude Desktop、LobeChat、Dify或自定义多代理集群)中,您可以立即为您的AI代理配备 程序化智能合约钱包.

而不是你的代理人打 402 Payment Required 如果出现错误和失败,他们现在可以自主协商支付墙,购买高级数据,通过Circle Gateway执行零气体微交易,并在高频保险库渠道中与其他代理交换计算资源。

Modexia为您的AI提供了一个银行账户,MCP为其提供了使用工具。


v0.4.1的新增功能

Circle Gateway纳米支付(x402) 此版本为MCP级别的无气体亚分微交易提供了全面的代理支持。

  • nanopay --获取一个受x402保护的URL,并使用EIP-3009离线签名自动协商付款。包括内联自动充值逻辑。
  • nanopay_activate --代理的一次性激活。
  • nanopay_deposit / nanopay_withdraw --直接从主钱包管理网关资金。
  • nanopay_balance --跟踪真实可用余额(网关存款减去待处理/未结算签名)。
  • 结构化错误处理 --MCP工具现在以结构化方式传递 ModexiaPaymentError 代码(例如。, INSUFFICIENT_MAIN_BALANCE)因此LLM可以推断故障并采取纠正措施。

上一篇:v0.3.0的新功能(意向支付)

基于意图的支付(v2) 通过严格的合规管道执行标准的USDC付款,并获得丰富的反馈。

  • submit_intent --创建签名意图,根据策略进行验证,并在链上执行。
  • get_intent / list_intents --审计跟踪和跟踪。

特征

  • Circle Gateway集成: 直接通过程序访问Circle的USDC纳米支付基础设施。
  • 无气体微交易: 发送低至0.000001美元的付款,区块链费用为零。
  • EIP-3009离线签名: 安全的链下支付授权,防止双重支出。
  • 基于意图的路由: 严格的政策执行、每日支出限制和加密审计跟踪。
  • 自动支付墙协商: 自动检测 402 Payment Required 标题,并内联完成它们。
  • 智能自动加油: 当资金不足时,从主钱包无缝充值网关余额。

暴露的MCP组件

工具

工具名称 描述
nanopay 汽车谈判和付款 402 Payment Required 使用EIP-3009离线签名的URL。
nanopay_activate 一次性激活命令,为代理启用Circle Gateway纳米支付。
nanopay_deposit 将资金从主代理钱包存入纳米支付网关。
nanopay_withdraw 将未使用的资金从网关中提取回主钱包。
nanopay_balance 检查真实可用余额(网关存款减去待处理签名)。
submit_intent 按照合规和政策执行标准USDC付款。
get_intent 检索以前提交的付款意图的状态和合规性元数据。
list_intents 获取最近的付款意向以进行审计跟踪审查。
open_channel 将资金锁定到高频微交易的智能合约中。
consume_channel 在开放渠道内执行即时无油小额支付。
settle_channel 关闭金库并在链上分配资金。
get_channel 检查特定支付渠道的当前容量和状态。
list_channels 列出与代理人钱包关联的所有支付渠道。
get_balance 检索代理主智能合约钱包的当前USDC余额。
get_history 获取代理的最近交易历史记录。
transfer 执行标准同步USDC转账(v1)。
cross_chain_transfer 通过Squid Router执行跨链CCTP支付(例如,以太坊->Akash)。
smart_fetch 基于HTTP的Paywalls的传统HTTP自动协商。

提示

提示名称 描述
nanopay_usage_instruction 为网关提供资金和执行的最佳实践 nanopay 操作。
create_intent_payment_instruction 构建合规付款、添加备忘录和处理政策拒绝的规则。
setup_microtransactions_instruction 关于打开、消耗和结算金库通道的分步指南。
create_payment_instruction 基于传统幂等性传输的标准规则。

资源

资源URI 描述
modexia://docs/llms_context 完整的《Modexia开发者协议指南》,其中包含蜂群的总体经济规则。

配置和设置

此服务器需要一个Modexia API密钥才能运行。您可以通过在以下网址创建开发人员帐户来获得一个 modexia软件.

变量 描述
MODEXIA_API_KEY 必修的。 您的Modexia开发者密钥(例如。 mx_test_...)
MODEXIA_BASE_URL 可选。覆盖API终结点。默认为沙盒环境。

使用 uvx (推荐)

您可以在任何支持标准可执行命令的MCP客户端中直接运行此服务器:

uvx modexia-mcp

克劳德桌面

要将Modexia与Claude Desktop一起使用,请将以下内容添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "modexia": {
      "command": "uvx",
      "args": ["modexia-mcp"],
      "env": {
        "MODEXIA_API_KEY": "mx_test_YourApiKeyHere"
      }
    }
  }
}

为开源做出贡献

我们积极欢迎社区的贡献,使这个MCP服务器变得更好。因为它是自主AI代理的主要接口,所以我们非常重视稳定性和严格的即时工程。

  1. 克隆回购: git clone https://github.com/Modexia/modexia-mcp.git
  2. 安装依赖关系: pip install -e .
  3. 本地运行: 您可以通过以下方式在stdio模式下运行服务器进行本地测试 python -m modexia_mcp
  4. 提交PR: 打开针对以下对象的拉取请求 main 支。

安全模型

Modexia MCP服务器 从不 将私钥暴露给LLM上下文。AI只允许触发明确配置的MCP工具。政策限制(例如,每日最大支出、每小时上限)在Modexia后端自动执行。即使是一个产生幻觉的人工智能也无法将你的钱包放在预定义的警卫之上。

许可证和支持

莫德夏mcp 是一个由 MIT许可证.

需要帮助扩展您的代理群或配置您的API密钥吗?访问您的开发人员仪表板并浏览以下文档 modexia软件.