Solana Vault MCP

这是一个用于Python中安全执行Solana区块链钱包操作的模型上下文协议（MCP）实现。

概述

Solana Vault MCP通过标准化的模型上下文协议接口，为Solana区块链提供安全的钱包操作。它允许AI助手在不直接访问私钥的情况下与Solana区块链进行安全交互。

特性

• 安全的Solana钱包操作
• SOL余额检查
• SOL转账功能
• 交易历史检索
• 符合Model Context Protocol的API
• 支持Flask网络服务器和WebSocket连接
• 详细的日志记录和错误处理

安装

预备条件

• Python 3.9+
• pip

设置

1. 克隆仓库：

   git clone https://github.com/olaxbt/solana-vault-mcp.git
   cd solana-vault-mcp
   

2. 创建并激活虚拟环境：

   python -m venv venv
   source venv/bin/activate  # 在Windows上：venv\Scripts\activate
   

3. 安装依赖项：

   pip install -r requirements.txt
   

4. 根据.env.example创建一个.env文件：

   cp .env.example .env
   

5. 编辑.env文件，添加您的Solana私钥和RPC URL。

使用方法

启动服务器

python run.py

服务器将在.env文件中指定的端口启动（默认：5000）。

API端点

• GET / - 包含服务信息的欢迎页面
• GET /health - 健康检查端点
• GET /api/mcp/ping - MCP服务健康检查
• POST /api/mcp/query - 主MCP查询端点

MCP动作

Solana Vault MCP支持以下动作：

1. wallet.info - 获取钱包信息
2. wallet.balance - 获取SOL余额
3. wallet.transfer - 将SOL转移到另一个钱包
4. wallet.transactions - 获取最近的交易
5. wallet.token_balance - 获取特定代币的余额

示例查询

{
  "id": "request123",
  "action": "wallet.balance",
  "params": {}
}

响应：

{
  "id": "request123",
  "result": {
    "balance": 1.5,
    "currency": "SOL",
    "address": "YourSolanaPublicKey"
  }
}

开发

项目结构

solana-vault-mcp/
├── app/
│   ├── handlers/        # 动作处理器
│   ├── routes/          # API路由
│   ├── services/        # 核心服务
│   └── utils/           # 工具
├── logs/                # 日志文件
├── tests/               # 测试用例
├── .env                 # 环境变量
├── .env.example         # 示例环境文件
├── requirements.txt     # 依赖项
├── run.py               # 主入口点
└── README.md            # 文档

运行测试

pytest

许可证

MIT

贡献

欢迎贡献！请随意提交Pull Request。