Hedera MCP Server

🚀 Hedera MCP サーバー

このプロジェクトは、Langchain ラッパーと統合されたサーバーを提供し、Hedera ネットワークとのやり取りを可能にします。ユーザーは自然言語コマンドで Hedera 操作を実行でき、これらの操作は Langchain 設定によって実現されます。

🚀 クイックスタート

前提条件

始める前に、以下のものがインストールされていることを確認してください。

• Node.js（推奨バージョン 20 以上）
• pnpm (npm install -g pnpm)
• Git

手順

このプロジェクトには、実行する必要のある 2 つのサービスが含まれています。

1. リポジトリをクローンする：

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

2. パッケージ内で環境変数を設定する：

   • .env.example ファイルをコピーし、以下の 2 つの場所に .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 ネットワークとのやり取りを行うことができます。