@sinco Labevm MCP Server

一個基於Model Context Protocol (MCP)和Viem的EVM交互服務網關，允許AI代理或服務安全地與配置的EVM兼容區塊鏈進行交互。

金融開發者工具 #EVM網關 #區塊鏈交互 #MCP協議 #智能合約 .TypeScript

評分 : 2分

下載量 : 10

更新時間 : 2025-04-23

什麼是EVM MCP 服務器？

EVM MCP 服務器是一個通過Model Context Protocol (MCP) 提供接口的服務網關，允許AI代理或其他客戶端安全地與EVM兼容的區塊鏈進行交互。它利用Viem庫的強大功能實現可靠且高效的EVM操作。

如何使用EVM MCP 服務器？

首先安裝並配置服務器，然後通過MCP接口連接客戶端（如Cursor或Claude）。服務器支持多種讀寫操作，例如查詢餘額、發送代幣以及與智能合約交互。

適用場景

適用於需要與EVM兼容鏈進行自動化交互的應用程序，例如去中心化金融（DeFi）、NFT市場等。

主要功能

獲取錢包地址獲取當前連接的錢包地址。

獲取鏈信息返回服務器連接的鏈ID和名稱。

查詢餘額檢查指定地址的本地代幣餘額。

簽名消息使用服務器配置的錢包對消息進行簽名。

發送原生代幣從服務器錢包向接收者發送ETH等原生代幣。

優勢與侷限性

優勢

支持多種EVM鏈

高效穩定的Viem庫

全面的API工具支持

侷限性

需要管理私鑰

標準配置文件可能涉及安全風險

如何使用

安裝依賴

確保已安裝Node.js 18.0.0及以上版本，並使用pnpm安裝項目依賴。

配置環境變量

創建.env文件並填寫WALLET_PRIVATE_KEY和RPC_PROVIDER_URL。

啟動服務器

運行構建後的JavaScript文件開始服務。

使用案例

查詢餘額查詢服務器錢包的ETH餘額。

發送ETH從服務器錢包向另一個地址發送1ETH。

常見問題

如何保護我的私鑰？

是否支持多條EVM鏈？

如何測試服務器功能？

🚀 以太坊模型上下文協議（EVMCP）服務器

本項目的以太坊模型上下文協議（EVMCP）服務器，能讓外部系統或應用程序通過多樣的工具接口，與以太坊區塊鏈進行交互，為開發者提供便捷的區塊鏈交互方案。

🚀 快速開始

環境要求

操作系統：支持 Linux 或 macOS（推薦）
Node.js 版本：16.0.0 或更高
pnpm 版本：4.0.0 或更高
以太坊 RPC 節點：需要一個可用的以太坊 JSON - RPC 端點（如 Infura、Alchemy 等）

安裝與運行

1. 克隆倉庫

git clone https://github.com/your-repository/evm-mcp-server.git
cd evm-mcp-server

2. 安裝依賴

pnpm install

3. 創建環境變量文件

複製 .env.example 文件並命名為 .env，然後根據需要修改配置：

cp .env.example .env

編輯 .env 文件並填寫以下內容：

WALLET_PRIVATE_KEY=your-wallet-private-key
RPC_PROVIDER_URL=https://eth-mainnet.alchemyapi.io/v2/your-api-key
DEFAULT_GAS_LIMIT=100000
DEFAULT_GAS_PRICE=200000

4. 編譯代碼

pnpm run build

5. 啟動服務器

pnpm run start

✨ 主要特性

提供一個可靠且易用的以太坊區塊鏈交互界面。
實現多種以太坊相關操作工具，支持地址管理、代幣操作等功能。
提供詳細的文檔和示例代碼，便於開發者集成和使用。

📦 項目結構

evm-mcp-server/
├── src/                # 核心服務代碼
│   ├── evm.ts          # 主服務器入口邏輯
│   └── evm-tools.ts    # 所有 MCP 工具的定義和實現
├── test/               # 測試代碼
│   └── client.ts       # 示例測試客戶端
├── build/              # 編譯生成的 JavaScript 代碼（由 `pnpm run build` 自動生成）
├── .env.example        # 環境變量示例文件
├── .env                # 環境變量配置文件（需自行創建，且不會被版本控制）
├── .gitignore          # 忽略文件列表
├── package.json        # 項目依賴和腳本
├── pnpm-lock.yaml      # pnpm 文件
├── tsconfig.json       # TypeScript 編譯器配置
├── README.md           # 英文版本說明
└── README.zh.md        # 中文版本說明

💻 使用示例

開發環境準備

pnpm run dev

測試代碼

pnpm test

調試日誌

pnpm run debug

📚 詳細文檔

可用工具

以下是當前服務器支持的所有工具及其描述：

工具名稱	描述
`getAddress`	獲取與服務器連接的錢包地址。
`getChain`	獲取服務器連接的鏈 ID 和鏈名。
`getBalance`	獲取指定地址（或服務器錢包）的原生代幣餘額。
`signTransaction`	對交易進行簽名，準備發送到區塊鏈。
`sendTransaction`	發送已簽名的交易到區塊鏈並返回交易哈希。
`deployContract`	部署新智能合約到區塊鏈。
`callContract`	調用已部署在區塊鏈上的智能合約方法。
`transferEth`	向指定地址發送以太坊原生代幣（ETH）。
`approveToken`	授權服務器錢包管理某個代幣的轉賬操作。

文檔引用

以太坊黃皮書：https://ethereum.org/en/whitepaper/
JSON - RPC 標準：https://www.jsonrpc.org/specification
Solidity 編程語言：https://soliditylang.org/

貢獻指南

歡迎社區貢獻！請參考 CONTRIBUTING.md 瞭解如何為本項目貢獻力量。

項目現狀

版本：v1.0.0
維護狀態：積極維護中
更新日誌：請查看 CHANGELOG.md

🔧 技術細節

本項目基於以太坊網絡構建了模型上下文協議（EVMCP）服務器。通過暴露多種工具接口，使得外部系統或應用程序能夠與以太坊區塊鏈進行交互。服務器的核心服務代碼位於 src 目錄下，其中 evm.ts 是主服務器入口邏輯，evm-tools.ts 定義和實現了所有 MCP 工具。測試代碼在 test 目錄下，通過 pnpm test 可以運行測試。