这是一个基于 Model Context Protocol (MCP) 的服务器端应用,旨在通过对话方式或工具调用,帮助用户便捷地进行跨链资产转移。
项目简介
该服务器利用 Meson Protocol 的能力,将复杂的跨链交易过程封装成易于通过 MCP 客户端(如支持 MCP 的大语言模型应用)调用的工具。用户可以通过与 LLM 交互,触发这些工具来完成跨链交易的准备、执行和状态查询。
主要功能点
- 跨链交易准备: 根据用户提供的源链、目标链、代币、金额、发送地址等信息,准备跨链交易数据并获取签名所需信息。
- 跨链交易执行: 使用用户提供的私钥(通过安全的环境变量配置)对交易数据进行签名,并将签名后的交易提交到 Meson 网络执行。
- 跨链交易状态查询: 根据交易 ID 查询已提交交易的当前状态和详细信息。
- 支持 Meson 协议支持的多种主流 EVM 和非 EVM 链及其代币。
- 支持主网和测试网环境。
- 私钥等敏感信息通过环境变量安全配置。
安装步骤
- 确保您已安装 Deno 运行时环境(版本 1.37.0 或更高)。
- 克隆本仓库到本地。
git clone https://github.com/demcp/demcp-meson-mcp.git cd demcp-meson-mcp - 准备一个用于签名和支付交易费用的以太坊兼容私钥。
服务器配置
本 MCP 服务器通常由 MCP 客户端或 MCP 管理工具启动和管理。以下是一个典型的 MCP 客户端配置示例,用于指定如何启动和连接此服务器。您需要根据您的 MCP 客户端的要求,将类似配置添加到您的 MCP 配置中:
这是一个用于MCP客户端的配置片段,告诉客户端如何启动和连接这个Meson MCP服务器:
- 服务器名称: 'meson-crosschain-mcp' (MCP客户端通过此名称引用该服务器)
- 启动命令 ('command'): 指定用于启动服务器的可执行程序,通常是 'deno' 或通过包管理器运行 Deno 脚本的命令(如 'npx deno' 或直接 'deno')。
- 命令参数 ('args'): 启动命令所需的参数列表。包括:
- 'run': Deno 的运行指令。
- '--allow-env': 允许 Deno 进程访问环境变量。
- '--allow-net': 允许 Deno 进程进行网络访问(用于调用 Meson API)。
- '--allow-read': 允许 Deno 进程读取文件(如果需要,本例中主要用于访问 JSR 包)。
- 'jsr:@demcp/meson-mcp': 指定从 JSR (JavaScript Registry) 运行 '@demcp/meson-mcp' 包。这是推荐的方式。
- 环境变量 ('env'): 启动服务器进程时需要设置的环境变量。
- 'MESON_PRIVATE_KEY': 用于签署交易的以太坊兼容私钥。请务必替换示例值 '0x1234...' 为您的实际私钥,并注意安全。
- 'MESON_USE_MAINNET': 设置为 '"true"' 启动服务器并连接 Meson 主网;设置为 '"false"' 或省略则连接 Meson 测试网。
请注意:私钥是敏感信息,请使用您 MCP 客户端或环境提供的安全方法来管理和设置 'MESON_PRIVATE_KEY' 环境变量。
基本使用方法
一旦 MCP 服务器成功启动并连接到您的 MCP 客户端(例如一个支持 MCP 的 LLM 应用),您就可以通过与客户端交互来使用服务器提供的功能。核心流程如下:
- 设置环境: 告知客户端您希望使用主网还是测试网(如果客户端支持)。
- 准备交易: 通过对话或明确调用 'prepareSwap' 工具,提供跨链交易所需的详细信息(如来源链、目标链、金额、代币、收款地址等)。服务器将返回交易的价格信息、编码数据和签名请求。
- 执行交易: 确认交易详情后,通过对话或调用 'executeSwap' 工具,将上一步获取的编码数据和签名请求提交给服务器。服务器将使用配置好的私钥进行本地签名并将交易提交到 Meson 网络。服务器将返回交易 ID 和结果。
- 查询状态: 使用上一步获得的交易 ID,通过对话或调用 'checkSwapStatus' 工具,查询交易的当前状态和详细进展。
重要提示: 主网交易涉及真实资产,请务必仔细核对交易细节。测试网是安全的练习环境,建议新用户优先在测试网尝试。确保用于交易签名的地址有足够的代币支付链上交易费用。
信息
分类
商业系统