Hedera MCP Server

Name: Hedera MCP Server
Author: mateuszm-arianelabs

本地服务

github.com/mateuszm-arianelabs金融数据078 周前更新

代码仓库

关于 Hedera MCP Server

Hedera MCP Server 通过 Langchain 封装层与 Hedera 网络交互，适用于需要以自然语言执行网络操作的场景。它将 MCP 请求转交给运行中的代理服务，以创建代币、转移 HBAR 或操作智能合约。

主要功能

01通过 Langchain 代理调用 Hedera
02支持创建代币和转移 HBAR
03支持与智能合约交互
04使用令牌验证 SSE 连接

适用场景

01通过自然语言执行 Hedera 操作
02创建代币或转移 HBAR
03调用 Hedera 智能合约
04以认证令牌连接 MCP 服务

MCP 相关

MCP 服务将请求转发给 Langchain 封装层，再由其执行 Hedera 网络操作。SSE 连接通过 X-MCP-AUTH-TOKEN 验证。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Hedera MCP 服务

本项目提供一个与 Langchain 封装集成的服务，用于与 Hedera 网络交互。借助 Langchain 配置，用户可以通过自然语言命令执行 Hedera 操作。

前提条件

开始之前，请确保已安装以下项目：

Node.js（建议使用 20 或更高版本）
pnpm（npm install -g pnpm）
Git

快速开始

整个项目包含两个需要运行的服务。

克隆代码库：

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

设置各软件包中的环境变量：
- 需要复制 .env.example 文件，并在以下两个位置基于它创建 .env：
  - packages/langchain-proxy
  - packages/mcp-server

编辑 .env 文件并填写所需的配置值（例如 Hedera 密钥、网络详情）。

API_URL=                  # url to langchain proxy endpoint
PORT=                     # port on which MCP server will be started
MCP_AUTH_TOKEN=           # array of accepted tokens separated by comas
LANGCHAIN_PROXY_TOKEN=    # token for accessing the Langchain proxy

安装依赖项：
```
pnpm install
```
启动 Lang chain 代理服务
```
pnpm run dev:lc
```
（如果已配置生产模式，也可以运行 pnpm start）。
运行 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 论坛不过，MCP 集成正在快速发展，预计 Cursor 和其他 MCP 客户端工具的未来版本将支持自定义标头。

可能迁移至 OAuth

截至 2025 年 3 月，官方 MCP OAuth 规范已发布，但仍存在一些限制和实现挑战。该方案可能会进行修订（来源）。

为未来集成 OAuth 做准备，以下是一些展示 MCP + OAuth 配置的示例代码库：

在未来的开发阶段考虑为 MCP 服务采用基于 OAuth 的身份验证时，可将这些示例作为参考。

简化架构

架构图

API 文档（langchain-proxy）

GET /sse

与 MCP 服务建立服务器发送事件（SSE）连接。

请求

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

Header	Type	Description
X-MCP-AUTH-TOKEN	string	必需的身份验证令牌，必须与服务 env 文件中的某个令牌相匹配（MCP_AUTH_TOKEN 变量）

响应

身份验证成功后，将建立一个内容类型为 text/event-stream 的 SSE 连接。

状态码

200 OK：连接成功建立 401 Unauthorized：身份验证令牌无效或缺失

错误响应

{
      "content": [
        {
          "type": "text",
          "content": "Unauthorized: Invalid or missing X-MCP-AUTH-TOKEN header"
        }
      ]
    }

支持 Markdown

登录后评论