Hedera MCP 服务器

本项目提供了一个与 Langchain 包装器集成的服务器，用于与 Hedera 网络进行交互。它允许用户通过 Langchain 设置提供的自然语言命令来执行 Hedera 操作。

前提条件

在开始之前，请确保已安装以下软件：

• 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. 启动 Lang chain Proxy 服务

   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"}
            }
        }
    }
}

注意：目前，Cursor IDE 不支持传递额外的标头（例如 X-MCP-AUTH-TOKEN）。 来源：Cursor Forum 但是，MCP 集成正在迅速发展，预计未来版本的 Cursor 和其他 MCP 客户端工具将添加对自定义标头的支持。

向 OAuth 的潜在过渡

截至 2025 年 3 月，官方 MCP OAuth 规范已发布，但它仍然存在一些限制和实施挑战。 可能会对该方法进行修订 (source)。

为了准备未来的 OAuth 集成，以下是一些展示 MCP + OAuth 设置的示例存储库：

• Cloudflare MCP + Auth0
• Cloudflare MCP + GitHub OAuth
• Geelen’s MCP Remote Example

在考虑未来开发阶段中基于 OAuth 的 MCP 服务器身份验证时，这些可以作为参考。

简化架构

API 文档 (langchain-proxy)

GET /sse

建立与 MCP 服务器的服务器发送事件 (SSE) 连接。

请求

GET /sse
X-MCP-AUTH-TOKEN: example-token

| 标头 | 类型 | 描述