Hedera MCP Server

🚀 Hedera MCP 服務器

本項目提供了一個與 Langchain 包裝器集成的服務器，用於和 Hedera 網絡進行交互。藉助該服務器，用戶能夠通過自然語言命令執行 Hedera 操作，這些操作由 Langchain 設置來實現。

🚀 快速開始

先決條件

在開始之前，請確保已安裝以下內容：

• Node.js（推薦版本 20 或更高）
• pnpm (npm install -g pnpm)
• Git

啟動步驟

整個項目包含兩個需要運行的服務，具體啟動步驟如下：

1. 克隆倉庫

   git clone https://github.com/mateuszm-arianelabs/hedera-mcp-server.git
   cd hedera-mcp-server
   

2. 設置環境變量 需要複製 .env.example 文件，並在以下兩個位置根據其創建 .env 文件：

   • packages/langchain-proxy
   • packages/mcp-server

編輯 .env 文件，並填寫所需的配置值（例如 Hedera 密鑰、網絡詳細信息）。

API_URL=                  # langchain 代理端點 URL
PORT=                     # MCP 服務器運行的端口
MCP_AUTH_TOKEN=           # 用逗號分隔的接受令牌數組
LANGCHAIN_PROXY_TOKEN=    # 訪問 Langchain 代理的令牌

3. 安裝依賴項

   pnpm install
   

4. 啟動 Langchain 代理服務

   pnpm run dev:lc
   

   （若已配置，也可使用 pnpm start 以生產模式啟動）。

5. 運行 mcp 服務器

   pnpm run dev:mcp
   

   （若已配置，同樣可使用 pnpm start 以生產模式啟動）。

✨ 主要特性

與 Hedera 交互

這是服務器的核心功能，允許服務器通過正在運行的 Langchain 包裝器服務進行調用。包裝器會解釋這些請求，並在 Hedera 網絡上執行相應的操作（例如創建代幣、轉移 HBAR、與智能合約交互）。

💻 使用示例

Visual Studio Code 的配置

為了與 MCP 服務器建立連接，需要 X-MCP-AUTH-TOKEN 頭。以下是用於 Visual Studio Code 的示例 .vscode/settings.json 配置：

{
    "mcp": {
        "inputs": [],
        "servers": {
            "hedera": {
                "type": "sse",
                "url": "http://localhost:3000/sse",
                "headers": { "X-MCP-AUTH-TOKEN": "your-mcp-auth-token"}
            }
        }
    }
}

⚠️ 重要提示

目前，傳遞自定義頭（例如 X-MCP-AUTH-TOKEN）在 Cursor IDE 中不受支持。來源

🔧 技術細節

潛在過渡到 OAuth

• Hedera 代幣服務：可探索 Hedera 的代幣服務，並結合其與智能合約的集成，實現更復雜的去中心化應用。
• Solidus 協議：瞭解如何在 Hedera 網絡上使用 Solidus 實現安全且可擴展的支付解決方案。

整體架構圖

系統組件簡要描述如下：

1. MCP 服務器：負責處理來自客戶端的請求，並通過 Langchain 包裝器與 Hedera 網絡交互。
2. Langchain 包裝器：作為中介，將自然語言指令轉換為 Hedera 網絡可以理解的操作。
3. Hedera 網絡：執行實際操作並返回結果。

📄 API 文檔

請求結構

所有請求都需要包含以下內容：

• Content-Type: application/json

響應結構

響應將採用 JSON 格式，示例如下：

{
    "code": 200,
    "message": "操作成功"
}

示例錯誤響應

當未提供有效令牌時，返回以下內容：

{
    "error": {
        "code": 401,
        "message": "未經授權：缺少有效的 X-MCP-AUTH-TOKEN 頭"
    }
}

端點示例

獲取狀態

curl --location 'http://localhost:3000/status' \
--header 'X-MCP-AUTH-TOKEN: your-token'

響應：

{
    "status": "ok",
    "timestamp": "2024-01-01T00:00:00.000Z"
}

執行操作

curl --location 'http://localhost:3000/execute' \
--header 'X-MCP-AUTH-TOKEN: your-token' \
--data-raw '{"operation": "創建代幣"}'

響應：

{
    "result": {
        "tokenAddress": "0.0.123456789"
    }
}

📚 總結

通過遵循上述步驟和文檔，您可以輕鬆設置和使用 Hedera MCP 服務器，並與 Hedera 網絡進行交互。