Meson 跨链交易 MCP 服务器

使用 Deno 和 TypeScript 实现的 Meson 跨链交易 MCP（模型上下文协议）服务器，帮助用户方便地在不同的区块链之间转移资产。

功能

• 基于 Meson 协议 的跨链资产转移
• 使用 MCP 标准进行对话式的跨链交易体验
• 完整集成跨链交易流程：交易准备、签名提交、状态查询
• 支持主网和测试网环境
• 使用环境变量配置私钥以确保安全
• 基于 Deno 运行时，无需复杂的依赖配置

需求

• Deno 1.37.0 或更高版本
• 与以太坊兼容的私钥（用于交易签名）

安装和运行

1. 克隆仓库

git clone <repository-url>
cd meson-mcp

2. 设置环境变量

# Linux/MacOS
export MESON_PRIVATE_KEY=your_private_key

# Windows
set MESON_PRIVATE_KEY=your_private_key

3. 运行 MCP 服务器

deno run --allow-net --allow-env main.ts

MCP 配置指南

您可以通过在 MCP 配置文件中添加以下配置来使用 Meson 跨链交易 MCP 服务：

"meson_mcp": {
  "command": "npx",
  "args": [
    "deno",
    "run",
    "--allow-env",
    "--allow-net",
    "--allow-read",
    "jsr:@demcp/meson-mcp"
  ],
  "env": {
    "MESON_PRIVATE_KEY": "0x1234567890abcdef",
    "MESON_USE_MAINNET": "true"
  }
}

配置参数

• command: 执行命令，这里使用 npx 来运行 Deno

• args: 命令参数列表

  • deno: 指定使用 Deno 运行时
  • run: Deno 的运行命令
  • --allow-env: 访问环境变量的权限 、 --allow-net: 网络访问权限
  • --allow-read: 文件读取权限
  • jsr:@demcp/meson-mcp: 从 JSR（JavaScript 注册表）加载的包名

• env: 环境变量配置

  • MESON_PRIVATE_KEY: 您的与以太坊兼容的私钥，用于交易签名（请替换示例值为您自己的密钥）
  • MESON_USE_MAINNET: 设置为 "true" 使用主网，设置为 "false" 或省略使用测试网

注意：出于安全考虑，请确保您的私钥不会泄露或公开。在生产环境中，建议使用安全的方法管理和存储私钥。

主要功能

MCP 服务器提供三个核心工具：

1. 准备跨链交易 (prepareSwap)

准备跨链交易并生成签名数据。

参数：

• fromChain: 源链 ID
• toChain: 目标链 ID
• fromToken: 源代币符号
• toToken: 目标代币符号
• amount: 交换数量
• fromAddress: 发送方地址
• recipient: 接收方地址（可选，默认为发送方）

返回：

• 价格信息
• 编码的交易数据
• 待签名的数据

2. 签名并执行交易 (executeSwap)

对交易数据进行签名并提交到 Meson 网络。

参数：

• encoded: 编码的交易数据
• signingRequest: 待签名的数据（包含消息和哈希）
• fromAddress: 发送方地址
• recipient: 接收方地址

返回：

• 交易 ID
• 交易结果信息

3. 查询交易状态 (checkSwapStatus)

检查已提交交易的状态。

参数：

• swapId: 交易 ID

返回：

• 交易状态
• 详细信息

使用示例

这是一个完整的跨链交易流程示例：

1. 设置环境（测试网/主网）

我想在测试网上执行一个跨链交易

2. 准备跨链交易

请准备一个从 Ethereum Sepolia 测试网向 Arbitrum Sepolia 转移 10 USDC 的交易，
我的地址是 0x1234...abcd

3. 签名并执行交易

请签名并提交上述准备的交易

4. 查询交易状态

请检查我刚刚提交的交易状态

重要注意事项

• 私钥仅存储在环境变量中，并且不会发送给任何外部服务
• 交易签名在本地完成，签名数据通过 Meson API 提交
• 主网交易涉及真实资产，请务必验证交易详情
• 测试网是一个安全的测试环境，新用户建议先在测试网上尝试
• 确保私钥有足够的原生代币（如 ETH）以支付交易费用

支持的链和代币

此 MCP 服务器支持 Meson 协议支持的所有区块链和代币，包括但不限于：

• 以太坊及其测试网
• Arbitrum
• Avalanche
• BSC
• Optimism
• Polygon
• Solana
• 以及其他许多 EVM 和非 EVM 链

具体支持的链和代币，请参阅 Meson 官方文档。

技术细节

• 基于 Model Context Protocol 实现
• 使用 Deno 作为运行时环境
• 通过 Meson API 进行跨链交易
• 使用 ethers 库进行交易签名

许可证

MIT