WalletMCP - Solana Blockchain MCP Server

WalletMCP - Solana 区块链 MCP 服务

WalletMCP 是一个用于与 Solana 区块链交互的模型上下文协议（MCP）服务实现。 它通过兼容 MCP 的接口，提供便于开发者使用的工具，用于处理钱包、交易、程序缓冲区、日志和 SOL 转账。

📺 演示视频

点击上方图片观看演示视频

🧠 功能

• 🔍 获取钱包交易记录和 SOL 余额。
• 📜 访问 Solana 区块链上的程序日志。
• 🧾 领取未使用的租金（列出并关闭 BPF 可升级加载器缓冲区）。
• 💸 以编程方式发送 SOL 交易。
• 🧩 使用 Zod 进行架构验证，提供完全符合 MCP 规范的工具定义。

🔧 使用的技术

• Solana Web3.js SDK – Solana 区块链交互
• Model Context Protocol（MCP） – 用于注册工具的协议
• Zod – 输入验证
• TypeScript – 强类型和现代化工具

📋 要求

• Node.js v16+
• Yarn 或 npm

🚀 开始使用

1. 克隆仓库

   git clone https://github.com/paulfruitful/WalletMCP
   

  ```bash
  cd walletMCP

2. 安装依赖项

   npm install
   

3. 构建 MCP 服务

   npm run build
   

测试服务：

要测试服务，可以使用 Claude Desktop MCP 客户端。点击此处下载桌面应用： 下载 Claude Desktop

用于 Claude Desktop

运行以下命令以打开 Claude Desktop 配置文件

在 Windows 上：

   code $env:AppData\Claude\claude_desktop_config.json

在 Mac/Linux 上：

   code ~/Library/Application\ Support/Claude/claude_desktop_config.json

打开配置文件后，添加服务：

{
  "mcpServers": {
    "walletmcp": {
      "command": "node",
      "args": [
          "YOUR_PATH_PREFIX\\WalletMCP\\build\\index.js"
      ]
  }
  }
}

一切就绪！ 现在，你可以在 Claude Desktop 中使用该服务提供的工具。 你可以向 Claude 客户端提出与 Solana 钱包相关的问题，以启用这些工具。

问题和提示词，例如：

• “我最近有哪些交易？”

• “我有多少 SOL？”

• “我有多少个未使用的缓冲区？”

• “你能向账户 [accountAddress] 发送 SOL 吗？”

• “特定程序 [programId] 的日志是什么？”

⚙️ 工具及其说明

getTransactions

说明：获取钱包的近期交易记录。
输入：

• walletAddress（字符串）
• limit（数字）- 要获取的最大交易数量。

getBalance

说明：获取钱包的 SOL 余额。
输入：

• walletAddress（字符串）

listBuffers

说明：列出与付款方密钥关联的程序缓冲区。
输入：

• payerKey（数字数组）

closeBuffer

说明：关闭缓冲区并将 lamports 返还给付款方。
输入：

• bufferPubkey（字符串）
• payerKey（数字数组）

getProgramLogs

说明：获取特定程序 ID 的交易日志。
输入：

• programId（字符串）
• limit（数字）- 可选，默认为 10

sendSolTransaction

说明：将 SOL 从一个钱包发送到另一个钱包。
输入：

• fromPrivateKey（数字数组）
• toPublicKeyStr（字符串）
• amountSol（数字）
• mode（"main" | "dev"）

🛡️ 安全注意事项

• 务必妥善保护私钥。
• 服务不会存储或记录密钥。

🤝 贡献

本项目欢迎 Solana 开发者社区贡献。 如果你有改进建议，欢迎提交议题或拉取请求。