Ambur MCP server

Ambur MCP サーバー

署名者によってブロードキャストされる Ambur のクエリおよび実行エントリーポイントメッセージをラップする、Rust 製 MCP サーバーです。

依存関係の設定

Cargo.toml の依存関係の一部は GitHub リポジトリから提供されており、その中にはプライベートリポジトリも含まれています。プライベートリポジトリへの読み取りアクセス権がない場合、残念ながらこのプロジェクトをビルドできません。

このプロジェクトは、複数の CosmWasm コントラクト用の MCP サーバーを開発する開発者向けにサンプルを提供しているため、オープンソースのまま公開されています。ご自身でビルドしてテストできるサンプルをお探しの場合は、cosmwasm-mcp-template リポジトリをご覧ください。このリポジトリとコードの大部分を共有していますが、プライベートな依存関係には依存していません。この2つのプロジェクトの主な違いは、cosmwasm-mcp-template には複数コントラクトのサポートが含まれていないことです。

このプロジェクトのビルド

このプロジェクトをビルドするには、Rust の nightly ビルドが必要です。これにより、rustc のエディション 2024 を使用できます。

# Switch rustc to `nightly` channel
rustup default nightly

# Build for development
cargo build

# Build for deployment
cargo build --release

この MCP サーバーが提供するツール

この MCP サーバーは、以下の15個のツールと機能を提供します。

1. list_contract_deployments - Ambur コアコントラクトのアドレス（メインネットおよびテストネット）を一覧表示します
2. list_nft_collections - Ambur NFT（メインネットおよびテストネットのコントラクトアドレス、コレクション名、コレクションの説明）を一覧表示します
3. list_query_entry_points - Ambur マーケットプレイスのコアコントラクトに対して実行できるクエリを一覧表示します
4. list_query_responses - Ambur マーケットプレイスのコアコントラクトに対して実行できるクエリから取得可能な、詳細なレスポンスデータを一覧表示します
5. build_query_msg - RPC に接続されたウォレットでブロードキャストできる、Ambur マーケットプレイスのコアコントラクトへのクエリを構築します
6. list_tx_entry_points - Ambur マーケットプレイスのコアコントラクトに対して実行できるトランザクションを一覧表示します
7. build_execute_msg - RPC に接続されたウォレットで署名してブロードキャストできる、Ambur マーケットプレイスのコアコントラクトへのトランザクションを構築します
8. list_token_query_entry_points - Ambur で取引可能な NFT トークン（例：Archies、Derpies、Foresight、Ghouls）に対して実行できるクエリを一覧表示します
9. build_token_query_msg - RPC に接続されたウォレットでブロードキャストできる、Ambur で取引可能な NFT トークン（例：Archies、Derpies、Foresight、Ghouls）へのクエリを構築します
10. list_token_tx_entry_points - Ambur で取引可能な NFT トークン（例：Archies、Derpies、Foresight、Ghouls）に対して実行できるトランザクションを一覧表示します
11. build_token_execute_msg - RPC に接続されたウォレットでブロードキャストできる、Ambur で取引可能な NFT トークン（例：Archies、Derpies、Foresight、Ghouls）へのトランザクションを構築します
12. list_minter_query_entry_points - Ambur で取引可能な NFT のミンターコントラクト（例：Archies ミンター、Derpies ミンター、Foresight ミンター、Ghouls ミンター）に対して実行できるクエリを一覧表示します
13. build_minter_query_msg - RPC に接続されたウォレットでブロードキャストできる、Ambur で取引可能な NFT トークンのミンターコントラクト（例：Archies ミンター、Derpies ミンター、Foresight ミンター、Ghouls ミンター）へのクエリを構築します
14. list_minter_tx_entry_points - Ambur で取引可能な NFT トークンのミンターコントラクト（例：Archies ミンター、Derpies ミンター、Foresight ミンター、Ghouls ミンター）に対して実行できるトランザクションを一覧表示します
15. build_minter_execute_msg - RPC に接続されたウォレットでブロードキャストできる、Ambur で取引可能な NFT トークンのミンターコントラクト（例：Archies ミンター、Derpies ミンター、Foresight ミンター、Ghouls ミンター）へのトランザクションを構築します

MCP を Claude Desktop に接続する

標準的なセットアップでは、リリースバイナリをビルドし、MCP サーバーの command にそのパスを指定します。実行引数（args）は必要ありません。

// claude_desktop_config.json
{
  "mcpServers": {
    "ambur": {
      "command": "/your-computer-path/ambur-mcp/target/release/ambur-mcp",
      "args": []
    }
  }
}

仮想マシン環境および WSL ユーザーの場合は、VM を command として実行し、実行引数（args）でバイナリを実行する場所を VM に指定します。

// claude_desktop_config.json
{
  "mcpServers": {
    "ambur": {
      "command": "wsl.exe",
      "args": [
        "bash",
        "-ic",
        "/your-vm-path/ambur-mcp/target/release/ambur-mcp",
      ]
    }
  }
}

MCP を LangGraph に接続する

グラフプロジェクトに @langchain/mcp-adapters をインストールする必要があります。このパッケージは MCP エンドポイントをグラフのツールに変換します。

@langchain/mcp-adapters を使用する

// graph.ts
import { MultiServerMCPClient } from "@langchain/mcp-adapters";
// ...
// Create client and connect to server
const client = new MultiServerMCPClient({
  throwOnLoadError: true,
  prefixToolNameWithServerName: true,
  additionalToolNamePrefix: "mcp",
  mcpServers: {
    ambur: {
      transport: "stdio",
      command: "~/mcp-servers/ambur-mcp", // path to pre-built linux binary 
                                          // stored in the Graph repo
      args: [],
      restart: {
        enabled: true,
        maxAttempts: 3,
        delayMs: 1000,
      },
    },
  },
});

const tools = await client.getTools();
// ...