关键词

CosmWasm区块链交互智能合约AI Agent数据查询交易执行

使用说明

项目简介

CosmWasm MCP 服务器是一个基于 Model Context Protocol (MCP) 标准构建的后端服务，旨在弥合大型语言模型 (LLM) 与 CosmWasm 区块链网络之间的鸿沟。它允许 AI Agent 通过标准化的 MCP 协议，安全、可编程地访问和操作 CosmWasm 区块链上的智能合约，从而实现更智能化的区块链应用集成。

主要功能点

  • 查询链上数据: 支持查询 CosmWasm 链上账户的余额、区块高度以及智能合约的状态数据。
  • 执行合约交易: 允许 AI Agent 调用 CosmWasm 智能合约的执行方法，发起链上交易，例如更新合约状态。
  • 工具化集成: 将区块链交互能力封装成易于 LLM 调用的工具 (Tools)，降低 AI Agent 与区块链交互的复杂性。
  • 标准 MCP 协议: 遵循 MCP 协议规范，确保与支持 MCP 协议的 LLM 客户端（如 Claude）的兼容性。

安装步骤

  1. 安装 Rust 环境: 确保你的开发环境中已安装 Rust 编程语言和 Cargo 包管理器。你可以访问 Rust官网 按照指引进行安装。

  2. 构建服务器: 克隆该 GitHub 仓库到本地，并使用 Cargo 构建服务器程序。在仓库根目录下执行以下命令：

    cargo build --release

    构建成功后，可执行文件将位于 'target/release/examples/cw-orch-mcp' (Linux/macOS) 或 'target/release/examples/cw-orch-mcp.exe' (Windows)。

服务器配置

要使 MCP 服务器与 Claude Desktop 等 MCP 客户端协同工作，你需要在客户端的配置文件中添加或更新 MCP 服务器的配置信息。以 Claude Desktop 为例，你需要编辑 'claude_desktop_config.json' 文件（macOS/Linux: '~/Library/Application\ Support/Claude/claude_desktop_config.json'，Windows: 'PATH-TO/claude_desktop_config.json'）。

在 'mcpServers' 字段下添加或修改 'cosmwasm-mcp' 的配置项。以下是配置示例，请根据你的实际情况修改 'command' 和 'env' 字段：

{
  "mcpServers": {
    "cosmwasm-mcp": {
      "command": "PATH-TO/rust-sdk/target/release/examples/cw-orch-mcp",  //  替换为你的 cw-orch-mcp 可执行文件的路径
      "args": [],
      "env": {
        "TEST_MNEMONIC": "<你的 24 位助记词>",  //  用于访问区块链的钱包助记词，请替换为你的助记词，注意安全保存！
        "RUST_LOG": "info"  //  设置日志级别，可选值包括：error, warn, info, debug, trace
      }
    }
  }
}

配置参数说明:

  • server name: 'cosmwasm-mcp' - 服务器名称，用于在 MCP 客户端中标识该服务器。
  • command: 'PATH-TO/rust-sdk/target/release/examples/cw-orch-mcp' (或 '.exe') - MCP 服务器可执行文件的完整路径。请务必根据你的实际构建路径替换 'PATH-TO' 部分。
  • args: '[]' - 传递给服务器可执行文件的命令行参数，当前配置为空数组，表示没有额外的命令行参数。
  • env: '{}' - 设置服务器运行时的环境变量。
    • TEST_MNEMONIC: '<你的 24 位助记词>' - 必填，用于访问 CosmWasm 区块链的钱包助记词。请替换为你自己的助记词，并务必妥善保管，避免泄露！
    • RUST_LOG: 'info' - 可选，设置 Rust 日志级别，用于控制服务器日志输出的详细程度。

注意:

  • 助记词安全: 'TEST_MNEMONIC' 环境变量中的助记词用于访问区块链资产，请务必谨慎配置，避免泄露，并确保你的助记词安全！ 在生产环境中，建议使用更安全的密钥管理方案。
  • 路径替换: 'command' 字段中的 'PATH-TO' 需要替换为 'cw-orch-mcp' 可执行文件在你本地文件系统中的实际路径。

基本使用方法

  1. 启动 MCP 服务器: 构建并配置完成后，MCP 服务器将在后台运行，监听来自 MCP 客户端的请求。服务器启动通常不需要手动执行，Claude Desktop 等客户端会自动启动配置的 MCP 服务器。

  2. 在 MCP 客户端中使用: 在支持 MCP 协议的 LLM 客户端（如 Claude Desktop）中，你可以通过自然语言指令调用 CosmWasm MCP 服务器提供的工具。例如，你可以尝试以下指令与 Claude 聊天：

    Please query 'neutron14kjnjnmeyz2pzaa9ga50dnsu5dwr39q0jhnz50nwr6yyqdkg6ayqwfsur2' for 'get_count'.  // 查询合约 neutron14kjnj... 的 get_count 方法
    Please increment 'neutron14kjnjnmeyz2pzaa9ga50dnsu5dwr39q0jhnz50nwr6yyqdkg6ayqwfsur2'  // 调用合约 neutron14kjnj... 的 increment 方法（假设合约有此方法）
    Please get the balance of neutron14kjnjnmeyz2pzaa9ga50dnsu5dwr39q0jhnz50nwr6yyqdkg6ayqwfsur2  // 查询地址 neutron14kjnj... 的账户余额

    客户端会解析你的指令，并将其转换为 MCP 请求发送给 CosmWasm MCP 服务器。服务器执行相应的区块链操作后，将结果返回给客户端，客户端再以自然语言形式呈现给你。

通过以上步骤，你就可以利用 CosmWasm MCP 服务器，在 LLM 应用中集成 CosmWasm 区块链的交互能力了。

信息

分类

网页与API

访问项目