Tempo MCP

节奏mcp

](https://npmjs.com/package/tempo-mcp)

用于Tempo区块链稳定币支付的MCP服务器 --使AI代理能够自主执行现实世界的支付。

仅限测试网 --该MCP目前在Tempo测试网上运行。没有使用真正的资金。非常适合实验和开发！

______________________________________________________________________

太长，读不下去了

添加到Claude桌面配置(~/.config/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "tempo": {
      "command": "npx",
      "args": ["tempo-mcp"],
      "env": { "TEMPO_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY" }
    }
  }
}

然后问克劳德： *“我的AlphaUSD余额是多少？”*

需要测试网令牌吗？ 获取免费AlphaUSD docs.tempo.xyz/水龙头

______________________________________________________________________

我能问什么？

______________________________________________________________________

什么是节拍mcp？

节奏mcp是一个 模型上下文协议（MCP） 连接人工智能助手和 Tempo区块链，为代理商务实现自主稳定币支付。

为什么这很重要

人工智能代理正在从助手演变为可以采取现实世界行动的自主行动者。然而，他们目前缺乏安全处理金融交易的能力。tempo-mcp通过提供以下功能来解决这个问题：

• 自主支付：AI代理可以在没有人为干预的情况下发送稳定币支付
• 内置安全：支出限制、地址分配和利率限制可防止失控交易
• 审计跟踪：记录每笔交易以进行合规和对账
• 备忘录支持：32字节备忘录支持发票匹配和付款对账

用例

• 工资自动化：处理CSV文件中的批量付款
• 发票结算：使用备注字段将付款与发票匹配
• 资金管理：自动重新平衡多代币投资组合
• 小额付费：启用按使用付费的人工智能服务
• 合规管理：自动化KYC/AML白名单维护和转账验证
• 委托代理人签名：使用具有支出限制的AI代理的访问密钥（会话密钥）
• 费用流动性准备金：通过向天然气转换费AMM提供流动性来赚取收益
• 自动化做市：下达在买入/卖出之间波动的翻转订单，以进行稳定币套利

______________________________________________________________________

特性

支付操作

• 单笔付款 --使用可选备忘录发送TIP-20稳定币转账
• 批量付款 --原子多收件人传输（最多100个收件人）
• 并发付款 --使用nonceKeys并行执行（大批量执行速度快10-100倍）
• 计划付款 --具有执行窗口的协议级未来支付
• 赞助付款 --赞助商支付费用的无气交易（本地密钥或中继服务）

查询操作

• 余额查询 --检查单个或多个令牌余额
• 交易查询 --获取交易详情和历史记录
• 天然气估算 --估算交易成本

令牌操作

• 代币创建 --通过工厂合约部署新的TIP-20代币
• 薄荷/烧伤 --代币供应管理（需要ISSUER_ROLE）
• 交换 --在Tempo的原生DEX上交换稳定币
• 角色管理 --授予、撤销和查询TIP-20角色（管理员、颁发者、暂停、取消使用）
• 暂停控制 --紧急暂停/取消暂停令牌传输（需要pause_ROLE/unpause_ROLE）
• 政策合规 --TIP-403白名单/黑名单管理和转移前验证
• 奖励管理 --TIP-20选择加入奖励：选择加入/退出、领取奖励、设置收件人、查看状态
• AMM流动性费用 --为天然气费用转换池提供流动性，并从稳定币掉期中获利
• DEX高级订单 --限价订单、翻转订单（自动反转）、订单簿查询和订单管理

安全

• 支出限额 --每个代币和每日美元限额
• 地址允许列表 --白名单或黑名单收件人地址
• 速率限制 --每种操作类型的可配置限制
• 审计日志 --带请求跟踪的结构化JSON日志
• 访问密钥（会话密钥） --具有每个令牌支出限制和到期的委托签名

钱包支持

• 私钥 --开发/测试的直接密钥
• 密钥库 --用于生产的加密JSON密钥库
• 外部签名者 --企业交钥匙/防火墙集成

______________________________________________________________________

快速开始

先决条件

• Node.js 20.0.0或更高版本
• npm、pnpm或yarn
• 带有AlphaUSD代币的Tempo测试网钱包

第一次？ 在以下网址获取钱包和免费测试网代币 docs.tempo.xyz/水龙头

安装

通过npm（全局安装）：

npm install -g tempo-mcp

通过npx（无需安装）：

npx tempo-mcp

来源：

git clone https://github.com/arome3/tempo-mcp
cd tempo-mcp
npm install
npm run build

配置

1. 创建 .env 文件：

cp .env.example .env

1. 添加您的钱包私钥：

# Required
TEMPO_PRIVATE_KEY=0x...  # Your wallet private key

# Network (defaults to testnet)
TEMPO_RPC_URL=https://rpc.testnet.tempo.xyz
TEMPO_CHAIN_ID=42429

1. 运行服务器：

npm start
# or
npx tempo-mcp

______________________________________________________________________

使用IDE进行安装

请在下面选择您的MCP客户端，以获取详细的设置说明。

注： 如果您使用的是此处未列出的客户端，您仍然可以通过手动将服务器配置添加到客户端的mcp设置中来使用tempo-mcp。

______________________________________________________________________

克劳德桌面版

下载并安装 克劳德桌面版 如果你还没有。

手动设置：

1. 打开克劳德桌面
2. 首选 设置 （齿轮图标）→ 开发者
3. 点击 编辑配置 打开配置文件

- macOS/Linux： ~/.config/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json

1. 添加以下配置：

{
  "mcpServers": {
    "tempo": {
      "command": "npx",
      "args": ["tempo-mcp"],
      "env": {
        "TEMPO_PRIVATE_KEY": "0x...",
        "TEMPO_RPC_URL": "https://rpc.testnet.tempo.xyz"
      }
    }
  }
}

1. 保存文件并重新启动Claude Desktop

______________________________________________________________________

克劳德代码（CLI）

安装 克劳德代码 如果你还没有。

1-单击设置：

claude mcp add tempo-mcp -e TEMPO_PRIVATE_KEY=0x... -- npx tempo-mcp

手动设置：

1. 打开终端
2. 跑 claude mcp add tempo-mcp 添加服务器
3. 或者直接编辑配置文件：

- macOS： ~/.claude/settings.json - Linux： ~/.claude/settings.json - 窗户： %USERPROFILE%\.claude\settings.json

1. 添加配置：

{
  "mcpServers": {
    "tempo": {
      "command": "npx",
      "args": ["tempo-mcp"],
      "env": {
        "TEMPO_PRIVATE_KEY": "0x..."
      }
    }
  }
}

1. 验证 /mcp Claude Code中的命令

______________________________________________________________________

光标

下载并安装 光标 如果你还没有。

手动设置：

1. 在Cursor中打开项目并导航到 光标设置 （macOS上的⌘+Shift+J）
2. 在设置菜单中，转到 主控程序 章节
3. 点击 新建MCP服务器。这将打开您的 mcp.json 配置文件

- 全球的： ~/.cursor/mcp.json - 项目级别： .cursor/mcp.json （以项目根为单位）

1. 添加以下配置：

{
  "mcpServers": {
    "tempo": {
      "command": "npx",
      "args": ["tempo-mcp"],
      "env": {
        "TEMPO_PRIVATE_KEY": "0x..."
      }
    }
  }
}

1. 保存并重新启动游标

提示： 项目级配置(.cursor/mcp.json)覆盖全局配置。

______________________________________________________________________

帆板运动

下载并安装 帆板运动 如果你还没有。

手动设置：

1. 打开Windsurf，前往 设置 （⌘+，在macOS上）
2. 导航到 级联 → 插件
3. 点击 查看原始配置 打开MCP配置文件

- macOS： ~/.codeium/windsurf/mcp_config.json - Linux： ~/.config/.codeium/windsurf/mcp_config.json - 窗户： %USERPROFILE%\.codeium\windsurf\mcp_config.json

1. 添加以下配置：

{
  "mcpServers": {
    "tempo": {
      "command": "npx",
      "args": ["tempo-mcp"],
      "env": {
        "TEMPO_PRIVATE_KEY": "0x..."
      }
    }
  }
}

1. 保存并重新启动Windsurf

______________________________________________________________________

VS代码+继续

安装 继续扩展 在VS代码中。

手动设置：

1. 打开VS Code并单击侧栏中的Continue图标
2. 点击齿轮图标→ 打开config.yaml

- macOS： ~/.continue/config.yaml - Linux： ~/.continue/config.yaml - 窗户： %USERPROFILE%\.continue\config.yaml

1. 添加以下配置（YAML格式）：

mcpServers:
  - name: tempo
    command: npx
    args:
      - tempo-mcp
    env:
      TEMPO_PRIVATE_KEY: "0x..."

1. 保存并重新加载VS代码

注： MCP工具仅在Continue中可用 代理模式.

______________________________________________________________________

克莱恩

安装 临床扩展 在VS代码中。

手动设置：

1. 打开VS Code并单击侧栏中的Cline图标
2. 点击 MCP服务器 顶部导航栏中的图标
3. 选择 配置 选项卡，然后单击 高级MCP设置
4. 这将在以下位置打开配置文件：

- macOS： ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json - 窗户： %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json - Linux： ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

1. 添加以下配置：

{
  "mcpServers": {
    "tempo": {
      "command": "npx",
      "args": ["tempo-mcp"],
      "env": {
        "TEMPO_PRIVATE_KEY": "0x..."
      },
      "alwaysAllow": [],
      "disabled": false
    }
  }
}

1. 保存后，服务器将立即可用

______________________________________________________________________

通用MCP客户端

对于自定义MCP客户端或编程使用：

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const transport = new StdioClientTransport({
  command: "npx",
  args: ["tempo-mcp"],
  env: {
    TEMPO_PRIVATE_KEY: process.env.TEMPO_PRIVATE_KEY,
  },
});

const client = new Client({ name: "my-agent", version: "1.0.0" }, {});
await client.connect(transport);

// Now you can call tools
const result = await client.callTool({
  name: "get_balance",
  arguments: { token: "AlphaUSD" },
});

______________________________________________________________________

MCP工具参考

支付工具（高风险）

查询工具（低风险）

代币工具（高风险）

政策工具（TIP-403合规性）

策略类型: whitelist （只有批准的地址才能进行交易）或 blacklist （块特定地址）。内置策略：0（始终拒绝），1（始终允许）。自定义策略从ID 2开始。

访问密钥工具（会话密钥）

奖励工具（TIP-20奖励）

持续时间：设置 duration=0 用于即时分发。计划为未来的协议更新提供基于时间的流媒体奖励（持续时间>0）。

Exchange工具

费用AMM工具（流动性管理）

DEX高级工具（订单交易）

Tick定价：价格=1+分/100000。勾0=1.0000美元，勾-10=0.9999美元，勾10=1.0001美元

______________________________________________________________________

MCP资源参考

资源通过URI模式提供对区块链数据的只读访问：

示例用法：

Read tempo://account/0x742d35Cc6634C0532925a3b844Bc9e7595f0bEbb

______________________________________________________________________

MCP提示参考

提示提供可重用的对话模板：

______________________________________________________________________

配置

环境变量

配置文件

创建 tempo-mcp.config.yaml 对于高级配置：

network:
  rpcUrl: https://rpc.testnet.tempo.xyz
  chainId: 42429
  explorerUrl: https://explore.tempo.xyz

wallet:
  type: privateKey  # or 'keystore', 'external'

security:
  spendingLimits:
    maxSinglePayment:
      "*": "1000"           # Default for all tokens
      AlphaUSD: "5000"      # Override for specific token
    dailyLimit:
      "*": "10000"
    dailyTotalUSD: "50000"
    maxBatchSize: 50
    maxBatchTotalUSD: "25000"

  addressAllowlist:
    enabled: true
    mode: allowlist         # or 'blocklist'
    addresses:
      - "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEbb"
    labels:
      "0x742d35Cc...": "Payroll Account"

  rateLimits:
    toolCalls:
      windowMs: 60000
      maxCalls: 60
    highRiskOps:
      windowMs: 3600000
      maxCalls: 100

logging:
  level: info
  auditLog:
    enabled: true
    path: ./logs/audit.jsonl
    rotationDays: 30

feeSponsorship:
  enabled: true
  feePayer:
    type: local              # or 'relay' for testnet relay service
    address: "0x..."         # Fee payer wallet address
    privateKey: "0x..."      # Fee payer private key (local mode only)
    relayUrl: "https://sponsor.testnet.tempo.xyz"  # Relay endpoint
  maxSponsoredPerDay: "1000" # Daily sponsorship limit

配置优先

1. 环境变量 （最高优先级）
2. 配置文件 （速度mcp.config.yaml/yml/json）
3. 默认值 （最低优先级）

______________________________________________________________________

安全

tempo-mcp包括多个安全层，以防止未经授权的交易：

支出限额

防止大额或超额付款：

security:
  spendingLimits:
    maxSinglePayment:
      "*": "1000"           # Max $1000 per transaction
    dailyLimit:
      "*": "10000"          # Max $10,000 per day per token
    dailyTotalUSD: "50000"  # Max $50,000 per day total

地址允许列表

限制哪些地址可以接收付款：

security:
  addressAllowlist:
    enabled: true
    mode: allowlist         # Only allow listed addresses
    addresses:
      - "0x..."             # Approved recipient
    labels:
      "0x...": "Vendor A"   # Human-readable label

速率限制

防止滥用和失控的代理人：

security:
  rateLimits:
    toolCalls:
      windowMs: 60000       # 1 minute window
      maxCalls: 60          # Max 60 calls per minute
    highRiskOps:
      windowMs: 3600000     # 1 hour window
      maxCalls: 100         # Max 100 high-risk ops per hour

审计日志

所有操作均已记录以确保合规性：

{"timestamp":"2024-12-17T10:30:00Z","requestId":"abc123","tool":"send_payment","status":"success","tx":"0x...","amount":"100","to":"0x..."}

______________________________________________________________________

例子

基本付款

User: "Send 50 AlphaUSD to 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEbb"

→ Claude calls send_payment({
    token: "AlphaUSD",
    to: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEbb",
    amount: "50"
  })

→ Returns: {
    success: true,
    transactionHash: "0xabc123...",
    explorerUrl: "https://explore.tempo.xyz/tx/0xabc123..."
  }

凭备忘录付款（发票对账）

User: "Pay invoice #INV-2024-001 for 1500 AlphaUSD to 0x..."

→ Claude calls send_payment({
    token: "AlphaUSD",
    to: "0x...",
    amount: "1500",
    memo: "INV-2024-001"
  })

批量工资单

User: "Process this month's payroll from employees.csv"

→ Claude calls batch_payments({
    token: "AlphaUSD",
    payments: [
      { to: "0x...", amount: "5000", label: "Alice" },
      { to: "0x...", amount: "4500", label: "Bob" },
      { to: "0x...", amount: "6000", label: "Carol" }
    ]
  })

赞助（无气）付款

User: "Send 100 AlphaUSD to 0x... using sponsored gas"

→ Claude calls send_sponsored_payment({
    token: "AlphaUSD",
    to: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEbb",
    amount: "100",
    useRelay: false  // Use local fee payer
  })

→ Returns: {
    success: true,
    transactionHash: "0xdef456...",
    feePayer: "0xabc...",
    feeAmount: "0.000073"
  }

代理示例

在中探索完整的代理实现 /examples 目录：

______________________________________________________________________

发展

设置

git clone https://github.com/arome3/tempo-mcp
cd tempo-mcp
npm install

可用脚本

测试

# Run all tests
npm test

# Run with coverage
npm run test:run -- --coverage

# Run specific test file
npm test -- src/security/spending-limits.test.ts

______________________________________________________________________

网络信息

Tempo测试网（安坦蒂诺）

默认令牌

______________________________________________________________________

文档

• Tempo文档 --Tempo区块链官方文档
• MCP规范 --模型上下文协议文档

______________________________________________________________________

技术栈

______________________________________________________________________

故障排除

“连接被拒绝”错误

• 确保已安装Node.js 20+： node --version
• 检查一下 TEMPO_PRIVATE_KEY 已在配置中设置

“余额不足”错误

• 从获取测试网令牌 水龙头
• 核实您的余额：问克劳德 *“我的余额是多少？”*

“超出支出限制”

• 增加 TEMPO_MAX_SINGLE_PAYMENT 在您的环境或配置文件中
• 检查 TEMPO_DAILY_LIMIT 如果你今天做了很多交易

“找不到令牌”错误

• 使用令牌符号(AlphaUSD)或完整地址(0x20c0...0001)
• 检查中支持的令牌 网络信息 章节

服务器未响应

• 配置更改后重新启动Claude Desktop
• 检查日志： tail -f ~/.config/Claude/logs/mcp*.log

______________________________________________________________________

许可证

MIT许可证——见 许可证 了解详情。

______________________________________________________________________

致谢

• 节奏 --稳定币支付区块链
• Anthropic --模型上下文协议
• 我知道 --TypeScript以太坊库

______________________________________________________________________

连接

建造于 亚伯拉罕 奥诺亚

 

有问题、反馈或想合作？伸出手来！

______________________________________________________________________

Built for the age of agentic commerce