ucai ABI-to-MCP - 智能合約AI接口工具，自動生成MCP服務器，助AI與區塊鏈合約交互

探索

Ucai

ABI-to-MCP是一個智能合約AI接口工具，能夠從任何智能合約ABI自動生成MCP服務器，讓Claude等AI助手可以直接與區塊鏈合約交互，支持安全掃描、合約解釋和多種預置模板。

開發者工具金融 #智能合約 #AI接口 #區塊鏈工具 #MCP生成 .Python

評分 : 2.5分

下載量 : 6.5K

更新時間 : 2026-03-13

打開站點

什麼是UCAI?

UCAI（Universal Contract AI Interface）是一個革命性的工具，它能夠將任何智能合約的ABI（應用二進制接口）自動轉換為AI可調用的工具。想象一下：你在Etherscan上找到一個合約，只需運行一個命令，Claude就能立即理解並使用這個合約的所有功能——查詢餘額、執行交易、查看歷史事件等。

如何使用UCAI?

使用UCAI非常簡單：1）找到你想使用的智能合約地址；2）運行 `abi-to-mcp generate` 命令；3）將生成的服務器添加到Claude Desktop配置中；4）現在Claude就能直接與該合約交互了。整個過程只需幾分鐘，無需編寫任何代碼。

適用場景

UCAI適用於：DeFi用戶想要AI幫助管理投資組合；開發者想要快速測試合約功能；研究人員想要分析鏈上數據；普通用戶想要用自然語言與區塊鏈交互。無論是Uniswap交易、Aave借貸、NFT查詢還是自定義合約，UCAI都能讓AI成為你的區塊鏈助手。

主要功能

一鍵生成MCP服務器

只需提供合約地址或ABI文件，自動生成完整的MCP服務器，包含所有函數和事件的工具定義。

智能安全掃描

內置安全分析器，自動檢測合約風險（如自毀函數、隱藏鑄幣權限等），在連接前提供安全評估。

合約解釋器

自動分析合約功能，用通俗語言解釋合約作用、權限結構和主要風險，幫助用戶理解複雜合約。

專業模板庫

提供預配置的DeFi套件模板，如閃電貸套件、多DEX套利套件、收益聚合器套件等，快速啟動複雜場景。

HTTP在線部署

無需本地安裝，通過HTTP端點直接使用UCAI服務，支持遠程調用和集成。

多鏈支持

支持以太坊、Polygon、Arbitrum、Optimism、Base等主流EVM鏈，以及Sepolia等測試網絡。

優勢

🚀 極速部署：從合約到AI工具只需10秒，相比手動開發節省數小時

🔒 安全優先：所有寫操作默認先模擬後執行，防止意外損失

🌐 通用兼容：支持任何EVM兼容鏈上的任何已驗證合約

🤖 AI原生設計：專為LLM工具調用優化，類型映射準確

📦 開箱即用：生成完整服務器包，包含配置、依賴和文檔

🛡️ 風險預警：內置50+風險模式檢測，提前識別潛在問題

侷限性

僅支持EVM兼容鏈，暫不支持Solana等其他區塊鏈

需要合約已驗證或提供ABI文件

複雜合約可能生成較多工具，需要AI有足夠上下文

寫操作需要配置私鑰，存在安全考慮

某些高級功能（如事件訂閱）需要額外配置

如何使用

安裝UCAI

通過pip安裝abi-to-mcp包

生成MCP服務器

使用合約地址生成服務器，這裡以Uniswap V2 Router為例

配置環境變量

進入生成的目錄，配置RPC節點和其他環境變量

添加到Claude Desktop

在Claude Desktop配置文件中添加MCP服務器

重啟並開始使用

重啟Claude Desktop，現在Claude就能使用該合約的所有功能了

使用案例

DeFi交易助手

讓Claude幫你分析最佳交易路徑並執行交易

借貸風險管理

監控DeFi借貸平臺的頭寸，預警清算風險

NFT收藏管理

查詢和管理NFT收藏品

合約數據分析

分析合約的歷史事件和狀態變化

常見問題

UCAI安全嗎？會不會讓我的資金有風險？

我需要懂編程才能使用UCAI嗎？

UCAI支持哪些區塊鏈？

生成的工具太多，Claude會不會混淆？

如果合約更新了怎麼辦？需要重新生成嗎？

UCAI是免費的嗎？

除了Claude，UCAI還支持其他AI助手嗎？

如何確保私鑰安全？

🚀 通用合約人工智能接口（UCAI）

通用合約人工智能接口（UCAI）是一種標準，用於定義人工智能代理與智能合約之間的交互方式。藉助 abi-to-mcp 工具，只需一個命令，就能將任何合約的ABI轉換為可被Claude調用的MCP服務器，讓AI輕鬆與智能合約交互。

🚀 快速開始

1. 生成服務器

abi-to-mcp generate 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D -o ~/uniswap-server
cd ~/uniswap-server && pip install -r requirements.txt

2. 連接到Claude桌面版

將以下內容添加到配置文件（Mac系統路徑為 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "uniswap": {
      "command": "python",
      "args": ["/Users/YOU/uniswap-server/server.py"],
      "env": {
        "RPC_URL": "https://eth.llamarpc.com"
      }
    }
  }
}

3. 向Claude提問

“用1 ETH兌換USDC的最佳路徑是什麼？”
“獲取ETH/DAI池的儲備量”
“展示Uniswap最近的交易”

現在，Claude就能理解並處理DeFi相關的問題了。

✨ 主要特性

🛡️ 安全掃描器：在連接合約之前，檢測50多種風險模式，如 rug pull、蜜罐等。
📖 合約解讀器：用通俗易懂的語言解釋合約的功能、權限和風險。
⚡ 專業模板：提供預構建的多合約包，適用於閃貸、套利、收益聚合等高級用例。
🌙 暗黑/明亮模式：保護眼睛，提供舒適的使用體驗。
📥 ZIP下載：下載包含 server.py、requirements.txt、README.md 等文件的完整服務器。
🔗 分享鏈接：通過 ?address=0x...&network=ethereum 分享服務器配置。

📦 安裝指南

安裝 `abi-to-mcp`

pip install abi-to-mcp

生成MCP服務器

abi-to-mcp generate <source> [options]

參數說明：

source：ABI文件路徑或合約地址 選項說明：
-o, --output PATH：輸出目錄（默認：./mcp-server）
-n, --network TEXT：地址查找的網絡（默認：mainnet）
-a, --address TEXT：合約地址（如果不在源文件中）
--name TEXT：服務器名稱（如果未提供，自動檢測）
--read-only：僅生成只讀操作
--no-events：不將事件作為資源
--no-simulate：默認禁用寫入操作的模擬

💻 使用示例

基礎用法

# Uniswap — Claude可以進行代幣交換
abi-to-mcp generate 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D -o ~/uniswap-server

# ETH 2.0 Beacon Deposit — Claude可以探索質押
abi-to-mcp generate 0x00000000219ab540356cBB839Cbe05303d7705Fa -o ~/eth-staking-server

# 任何經過驗證的合約都可以使用
abi-to-mcp generate <ANY_CONTRACT_ADDRESS>

高級用法

# 自定義輸出目錄和網絡
abi-to-mcp generate 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D -o ~/custom-server -n sepolia

📚 詳細文檔

生成的服務器結構

my-mcp-server/
├── server.py           # 主MCP服務器
├── config.py           # 配置文件
├── requirements.txt    # 依賴項
├── README.md           # 文檔
├── pyproject.toml      # 包配置
└── .env.example        # 環境模板

類型映射

Solidity類型	JSON Schema	Python類型
`address`	`string` 帶模式	`str`
`uint256`	`string`（用於精度）	`str`
`uint8-uint32`	`integer` 帶邊界	`int`
`bool`	`boolean`	`bool`
`string`	`string`	`str`
`bytes`	`string` 帶模式	`str`
`bytes32`	`string` 帶模式	`str`
`tuple`	`object`	`Dict`
`T[]`	`array`	`List`
`T[N]`	`array` 帶邊界	`List`

環境變量

變量	描述	是否必需
`RPC_URL`	Web3 RPC端點	是
`CONTRACT_ADDRESS`	覆蓋合約地址	否
`PRIVATE_KEY`	用於寫入操作	寫入時必需
`ETHERSCAN_API_KEY`	從Etherscan獲取數據	使用Etherscan時必需

支持的網絡

網絡	ID	鏈ID
`mainnet`	以太坊	1
`sepolia`	Sepolia測試網	11155111
`polygon`	多邊形網絡	137
`arbitrum`	Arbitrum One	42161
`optimism`	樂觀網絡	10
`base`	Base網絡	8453
`bsc`	BNB鏈	56
`avalanche`	雪崩C鏈	43114

🔧 技術細節

UCAI標準

UCAI定義了AI代理與智能合約交互的標準，包括工具模式、類型映射、安全模式和事件查詢等。通過 abi-to-mcp 工具，可以將任何合約的ABI轉換為符合UCAI標準的MCP服務器，使AI能夠方便地與智能合約進行交互。

安全機制

私鑰管理：私鑰僅從環境變量加載，絕不從文件或命令行獲取。
默認模擬：寫入操作先進行模擬，可通過 simulate=False 執行實際操作。
只讀模式：使用 --read-only 完全禁用寫入操作。
氣體保護：可配置最大氣體價格限制。

📄 許可證

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

🌐 即時HTTP部署

UCAI — ABI to MCP 通過 MCP Streamable HTTP 傳輸協議進行部署，可通過HTTP訪問，無需本地安裝。

端點

https://modelcontextprotocol.name/mcp/ucai

從任何MCP客戶端連接

將以下內容添加到MCP客戶端配置（Claude Desktop、Cursor、SperaxOS等）：

{
  "mcpServers": {
    "ucai": {
      "type": "http",
      "url": "https://modelcontextprotocol.name/mcp/ucai"
    }
  }
}

可用工具（5個）

工具	描述
`lookup_contract`	查找智能合約
`get_token_by_contract`	通過合約獲取代幣元數據
`get_price`	獲取加密貨幣價格
`search_coins`	搜索加密貨幣
`get_coin_detail`	獲取加密貨幣詳情

示例請求

查找智能合約

curl -X POST https://modelcontextprotocol.name/mcp/ucai \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"lookup_contract","arguments":{"address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}}}'

通過合約獲取代幣元數據

curl -X POST https://modelcontextprotocol.name/mcp/ucai \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_token_by_contract","arguments":{"address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}}}'

獲取加密貨幣價格

curl -X POST https://modelcontextprotocol.name/mcp/ucai \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_price","arguments":{"ids":"usd-coin","vs_currencies":"usd"}}}'

列出所有工具

curl -X POST https://modelcontextprotocol.name/mcp/ucai \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'