Safe MCP Server

🚀 安全 MCP 服务器

安全 MCP 服务器是一个用于与安全（前身为 Gnosis Safe）智能合约钱包进行交互的实现，借助 MCP (Model Context Protocol) 协议，可实现对安全钱包交易的查询、详情获取以及数据解码等功能。

🚀 快速开始

本服务器使用便捷，无需复杂配置，默认使用安全事务主网端点。按以下步骤操作即可启动：

npm install
npm run build
npm start

✨ 主要特性

• 可查询任意安全地址的所有交易。
• 能获取多签事务的详细信息。
• 支持解码交易数据。
• 集成了安全 API。

📦 安装指南

使用以下命令进行安装：

npm install

💻 使用示例

基础用法

启动服务器后，可使用以下工具与安全智能合约钱包进行交互。

getSafeTransactions

根据上下文确定的任意安全地址，获取所有交易。该地址由 LLM 在运行时动态确定。

// 示例工具调用
getSafeTransactions({
  address: "0x123...", // 上下文中确定的安全地址
  limit: 100, // 可选参数
  offset: 0, // 可选参数
});

getMultisigTransaction

获取特定多签事务的详细信息。

getMultisigTransaction({
  safeTxHash: "0x456...", // 查询的事务哈希
});

decodeTransactionData

使用安全 API 解码交易数据。

decodeTransactionData({
  data: "0x789...", // 需要解码的数据部分
  to: "0xabc...", // 可选的目标合约地址
});

高级用法

配置其他端点

默认情况下，服务器使用安全事务主网端点：

https://safe-transaction-mainnet.safe.global/api/v1

如果需要使用其他端点（例如测试网），可通过环境变量设置：

SAFE_API_URL=https://safe-transaction-goerli.safe.global/api/v1 npm start

🔧 技术细节

在开发过程中，可使用以下命令启动开发模式：

npm run dev

📄 许可证

本项目采用 MIT 许可证。