Ambur MCP server

Ambur MCP 服务

使用 Rust 编写的 MCP 服务，用于封装 Ambur 查询和执行入口消息，以便由签名者广播。

配置依赖项

Cargo.toml 中的部分依赖项由 GitHub 仓库提供，其中一些仓库是私有的。如果你没有这些私有仓库的读取权限，很遗憾，你将无法构建此项目。

此项目仍然保持开源，因为它为开发者构建面向多个 CosmWasm 合约的 MCP 服务提供了示例。如果你想要一个可以自行构建和测试的示例，请查看 cosmwasm-mcp-template 仓库；它与此仓库共享大部分代码，但不依赖任何私有依赖项。这两个项目的主要区别在于，cosmwasm-mcp-template 不包含多合约支持。

构建此项目

构建此项目需要使用 Rust 的 nightly 版本，这样才能使用 rustc 的 edition 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 - 构建发送至 Ambur 核心市场合约的查询，以便由连接 RPC 的钱包广播
6. list_tx_entry_points - 列出可发送至 Ambur 核心市场合约的交易
7. build_execute_msg - 构建发送至 Ambur 核心市场合约的交易，以便由连接 RPC 的钱包签名并广播
8. list_token_query_entry_points - 列出可发送至可在 Ambur 上交易的 NFT 代币（例如 Archies、Derpies、Foresight 和 Ghouls）的查询
9. build_token_query_msg - 构建发送至可在 Ambur 上交易的 NFT 代币（例如 Archies、Derpies、Foresight 和 Ghouls）的查询，以便由连接 RPC 的钱包广播
10. list_token_tx_entry_points - 列出可发送至可在 Ambur 上交易的 NFT 代币（例如 Archies、Derpies、Foresight 和 Ghouls）的交易
11. build_token_execute_msg - 构建发送至可在 Ambur 上交易的 NFT 代币（例如 Archies、Derpies、Foresight 和 Ghouls）的交易，以便由连接 RPC 的钱包广播
12. list_minter_query_entry_points - 列出可发送至可在 Ambur 上交易的 NFT 的铸造合约（例如 Archies、Derpies、Foresight 和 Ghouls 的铸造合约）的查询
13. build_minter_query_msg - 构建发送至可在 Ambur 上交易的 NFT 代币的铸造合约（例如 Archies、Derpies、Foresight 和 Ghouls 的铸造合约）的查询，以便由连接 RPC 的钱包广播
14. list_minter_tx_entry_points - 列出可发送至可在 Ambur 上交易的 NFT 代币的铸造合约（例如 Archies、Derpies、Foresight 和 Ghouls 的铸造合约）的交易
15. build_minter_execute_msg - 构建发送至可在 Ambur 上交易的 NFT 代币的铸造合约（例如 Archies、Derpies、Foresight 和 Ghouls 的铸造合约）的交易，以便由连接 RPC 的钱包广播

将 MCP 连接到 Claude Desktop

对于默认配置，请构建一个发布版本二进制文件，并将 MCP 服务的 command 指向其路径。无需运行参数（args）：

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

对于虚拟机配置和 WSL 用户，请将虚拟机作为 command 执行，并使用运行参数（args）指定虚拟机运行二进制文件的位置：

// 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();
// ...