Tempo MCP

🚀 tempo-mcp

tempo-mcp 是一個用於Tempo區塊鏈穩定幣支付的MCP服務器，它能讓AI智能體自主執行現實世界的支付操作。目前，該MCP僅在Tempo測試網上運行，不涉及真實資金交易，非常適合進行實驗和開發！

🚀 快速開始

前提條件

• Node.js 20.0.0 或更高版本
• npm、pnpm 或 yarn
• 擁有AlphaUSD代幣的Tempo測試網錢包

首次使用？ 可在 docs.tempo.xyz/faucet 獲取錢包和免費的測試網代幣。

安裝

通過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

2. 添加你的錢包私鑰：

# 必需
TEMPO_PRIVATE_KEY=0x...  # 你的錢包私鑰

# 網絡（默認為測試網）
TEMPO_RPC_URL=https://rpc.testnet.tempo.xyz
TEMPO_CHAIN_ID=42429

3. 運行服務器：

npm start
# 或者
npx tempo-mcp

✨ 主要特性

支付操作

• 單筆支付 — 可發送帶有可選備註的TIP - 20穩定幣轉賬。
• 批量支付 — 支持原子性的多接收方轉賬（最多100個接收方）。
• 併發支付 — 使用nonceKeys進行並行執行，對於大批量交易，速度比順序執行快10 - 100倍。
• 定時支付 — 支持協議級別的未來支付，並帶有執行窗口。
• 贊助支付 — 實現無Gas交易，由贊助方支付費用（可使用本地密鑰或中繼服務）。

查詢操作

• 餘額查詢 — 可檢查單個或多個代幣的餘額。
• 交易查詢 — 獲取交易詳情和歷史記錄。
• Gas估算 — 估算交易成本。

代幣操作

• 代幣創建 — 通過工廠合約部署新的TIP - 20代幣。
• 鑄造/銷燬 — 管理代幣供應（需要ISSUER_ROLE）。
• 兌換 — 在Tempo的原生DEX上兌換穩定幣。
• 角色管理 — 授予、撤銷和查詢TIP - 20角色（管理員、發行者、暫停、恢復）。
• 暫停控制 — 緊急暫停/恢復代幣轉賬（需要PAUSE_ROLE/UNPAUSE_ROLE）。
• 策略合規性 — 管理TIP - 403白名單/黑名單，並進行轉賬前驗證。
• 獎勵管理 — TIP - 20選擇加入獎勵：選擇加入/退出、領取獎勵、設置接收方、查看狀態。
• 費用AMM流動性 — 為Gas費用轉換池提供流動性，並從穩定幣兌換中獲利。
• DEX高級訂單 — 限價訂單、翻轉訂單（自動反轉）、訂單簿查詢和訂單管理。

安全特性

• 消費限制 — 支持每個代幣和每日美元限額。
• 地址白名單 — 可對接收方地址進行白名單或黑名單設置。
• 速率限制 — 可對每種操作類型進行可配置的限制。
• 審計日誌 — 帶有請求跟蹤的結構化JSON日誌。
• 訪問密鑰（會話密鑰） — 支持委託簽名，並帶有每個代幣的消費限制和過期時間。

錢包支持

• 私鑰 — 適用於開發/測試的直接密鑰。
• 密鑰庫 — 適用於生產環境的加密JSON密鑰庫。
• 外部簽名者 — 支持與Turnkey/Fireblocks集成，適用於企業級應用。

📦 安裝指南

安裝到IDE

可選擇以下MCP客戶端，獲取詳細的設置說明。

注意： 若使用的客戶端未在此列出，仍可通過手動將服務器配置添加到客戶端的MCP設置中，來使用tempo - mcp。

Claude Desktop

若尚未安裝 Claude Desktop，請先下載並安裝。

手動設置：

1. 打開Claude Desktop。
2. 轉到 設置（齒輪圖標）→ 開發者。
3. 點擊 編輯配置 以打開配置文件：
   • macOS/Linux：~/.config/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
4. 添加以下配置：

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

5. 保存文件並重啟Claude Desktop。

Claude Code (CLI)

若尚未安裝 Claude Code，請先進行安裝。

一鍵設置：

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
   • Windows：%USERPROFILE%\.claude\settings.json
4. 添加配置：

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

5. 在Claude Code中使用 /mcp 命令進行驗證。

Cursor

若尚未安裝 Cursor，請先下載並安裝。

手動設置：

1. 在Cursor中打開一個項目，然後導航到 Cursor設置（在macOS上按⌘ + Shift + J）。
2. 在設置菜單中，轉到 MCP 部分。
3. 點擊 新建MCP服務器，這將打開 mcp.json 配置文件：
   • 全局：~/.cursor/mcp.json
   • 項目級：.cursor/mcp.json（在項目根目錄下）
4. 添加以下配置：

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

5. 保存並重啟Cursor。

提示： 項目級配置（.cursor/mcp.json）會覆蓋全局配置。

Windsurf

若尚未安裝 Windsurf，請先下載並安裝。

手動設置：

1. 打開Windsurf，然後轉到 設置（在macOS上按⌘ + ,）。
2. 導航到 Cascade → 插件。
3. 點擊 查看原始配置 以打開MCP配置文件：
   • macOS：~/.codeium/windsurf/mcp_config.json
   • Linux：~/.config/.codeium/windsurf/mcp_config.json
   • Windows：%USERPROFILE%\.codeium\windsurf\mcp_config.json
4. 添加以下配置：

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

5. 保存並重啟Windsurf。

VS Code + Continue

在VS Code中安裝 Continue擴展。

手動設置：

1. 打開VS Code，然後點擊側邊欄中的Continue圖標。
2. 點擊齒輪圖標 → 打開config.yaml：
   • macOS：~/.continue/config.yaml
   • Linux：~/.continue/config.yaml
   • Windows：%USERPROFILE%\.continue\config.yaml
3. 添加以下配置（YAML格式）：

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

4. 保存並重新加載VS Code。

注意： MCP工具僅在Continue的 智能體模式 下可用。

Cline

在VS Code中安裝 Cline擴展。

手動設置：

1. 打開VS Code，然後點擊側邊欄中的Cline圖標。
2. 點擊頂部導航欄中的 MCP服務器 圖標。
3. 選擇 配置 選項卡，然後點擊 高級MCP設置。
4. 這將打開配置文件，路徑如下：
   • macOS：~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Windows：%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
5. 添加以下配置：

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

6. 保存後，服務器將立即可用。

通用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);

// 現在可以調用工具
const result = await client.callTool({
  name: "get_balance",
  arguments: { token: "AlphaUSD" },
});

💻 使用示例

基本支付

用戶：“向0x742d35Cc6634C0532925a3b844Bc9e7595f0bEbb發送50個AlphaUSD”

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

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

帶備註的支付（發票對賬）

用戶：“向0x...支付1500個AlphaUSD，用於支付發票#INV - 2024 - 001”

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

批量工資支付

用戶：“從employees.csv文件處理本月工資”

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

贊助（無Gas）支付

用戶：“使用贊助Gas向0x...發送100個AlphaUSD”

→ Claude調用send_sponsored_payment({
    token: "AlphaUSD",
    to: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEbb",
    amount: "100",
    useRelay: false  // 使用本地費用支付者
  })

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

示例智能體

可在 /examples 目錄中探索完整的智能體實現：

📚 詳細文檔

MCP工具參考

支付工具（高風險）

查詢工具（低風險）

代幣工具（高風險）

策略工具（TIP - 403合規性）

策略類型：whitelist（僅允許批准的地址進行交易）或 blacklist（阻止特定地址）。內置策略：0（始終拒絕），1（始終允許）。自定義策略從ID 2開始。

訪問密鑰工具（會話密鑰）

獎勵工具（TIP - 20獎勵）

持續時間：設置 duration = 0 可進行即時分配。基於時間的流式獎勵（duration > 0）計劃在未來的協議更新中實現。

交換工具

費用AMM工具（流動性管理）

DEX高級工具（訂單簿交易）

Tick定價：價格 = 1 + tick / 100,000。Tick 0 = $1.0000，tick - 10 = $0.9999，tick 10 = $1.0001

MCP資源參考

資源通過URI模式提供對區塊鏈數據的只讀訪問：

示例用法：

讀取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  # 或 'keystore', 'external'

security:
  spendingLimits:
    maxSinglePayment:
      "*": "1000"           # 所有代幣的默認值
      AlphaUSD: "5000"      # 特定代幣的覆蓋值
    dailyLimit:
      "*": "10000"
    dailyTotalUSD: "50000"
    maxBatchSize: 50
    maxBatchTotalUSD: "25000"

  addressAllowlist:
    enabled: true
    mode: allowlist         # 或 'blocklist'
    addresses:
      - "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEbb"
    labels:
      "0x742d35Cc...": "工資賬戶"

  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              # 或 'relay' 用於測試網中繼服務
    address: "0x..."         # 費用支付者錢包地址
    privateKey: "0x..."      # 費用支付者私鑰（僅本地模式）
    relayUrl: "https://sponsor.testnet.tempo.xyz"  # 中繼端點
  maxSponsoredPerDay: "1000" # 每日贊助限額

配置優先級

1. 環境變量（最高優先級）
2. 配置文件（tempo - mcp.config.yaml/yml/json）
3. 默認值（最低優先級）

🔧 技術細節

安全機制

tempo - mcp包含多個安全層，以防止未經授權的交易：

消費限制

可防止大額或過度支付：

security:
  spendingLimits:
    maxSinglePayment:
      "*": "1000"           # 每筆交易最大1000美元
    dailyLimit:
      "*": "10000"          # 每個代幣每天最大10000美元
    dailyTotalUSD: "50000"  # 每天總計最大50000美元

地址白名單

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

security:
  addressAllowlist:
    enabled: true
    mode: allowlist         # 僅允許列入名單的地址
    addresses:
      - "0x..."             # 批准的接收方
    labels:
      "0x...": "供應商A"   # 人類可讀的標籤

速率限制

可防止濫用和失控的智能體：

security:
  rateLimits:
    toolCalls:
      windowMs: 60000       # 1分鐘窗口
      maxCalls: 60          # 每分鐘最多60次調用
    highRiskOps:
      windowMs: 3600000     # 1小時窗口
      maxCalls: 100         # 每小時最多100次高風險操作

審計日誌

所有操作都會被記錄，以確保合規性：

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

開發

環境搭建

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

可用腳本

測試

# 運行所有測試
npm test

# 運行並生成覆蓋率報告
npm run test:run -- --coverage

# 運行特定測試文件
npm test -- src/security/spending-limits.test.ts

網絡信息

Tempo測試網（Andantino）

默認代幣

技術棧

故障排除

“連接被拒絕”錯誤

• 確保已安裝Node.js 20+：node --version
• 檢查配置中是否設置了 TEMPO_PRIVATE_KEY

“餘額不足”錯誤

• 從 水龍頭 獲取測試網代幣
• 驗證餘額：向Claude詢問 “我的餘額是多少？”

“消費限額已超出”

• 在環境變量或配置文件中增加 TEMPO_MAX_SINGLE_PAYMENT
• 若當天進行了多次交易，請檢查 TEMPO_DAILY_LIMIT

“未找到代幣”錯誤

• 使用代幣符號（AlphaUSD）或完整地址（0x20c0...0001）
• 檢查 網絡信息 部分中支持的代幣

服務器無響應

• 更改配置後重啟Claude Desktop
• 檢查日誌：tail -f ~/.config/Claude/logs/mcp*.log

📄 許可證

本項目採用MIT許可證，詳情請參閱 LICENSE。

致謝

• Tempo — 穩定幣支付區塊鏈
• Anthropic — 模型上下文協議
• viem — TypeScript以太坊庫

聯繫我們

本項目由 Abraham Onoja 開發。

如有疑問、反饋或想要合作，請隨時聯繫！

為智能商業時代而構建