Solana钱包服务

一个提供实时Solana区块链钱包功能的MCP服务器,适用于AI助手。

  • by agentis-dev
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 agentis-dev/solana-wallet-mcp

使用说明

Solana钱包MCP

模型上下文协议(MCP)服务器,为AI助手提供实时Solana区块链钱包功能。

项目结构

.
├── src/
│   ├── server.ts              # Main MCP server implementation
│   ├── handlers/
│   │   ├── wallet.ts          # Wallet operations handlers
│   │   ├── transactions.ts    # Transaction handlers
│   │   └── tokens.ts          # Token operations handlers
│   ├── utils/
│   │   ├── solana.ts          # Solana connection utilities
│   │   ├── validation.ts      # Input validation utilities
│   │   └── formatting.ts      # Response formatting utilities
│   ├── types/
│   │   └── index.ts           # TypeScript type definitions
│   └── config/
│       └── constants.ts       # Configuration constants
├── config/
│   └── networks.json          # Solana network configurations
├── docs/
│   ├── API.md                 # API documentation
│   └── SETUP.md              # Setup instructions
├── progress/
│   └── development.md         # Development progress tracking
├── tests/
│   ├── wallet.test.ts         # Wallet functionality tests
│   └── integration.test.ts    # Integration tests
├── package.json
├── tsconfig.json
├── .env.example
└── .gitignore

特性

  • 实时钱包监控:跟踪余额变化和交易
  • 多网络支持:主网、开发网和测试网兼容性
  • 全面的钱包操作:
    • 余额检查(SOL和SPL代币)
    • 交易历史检索
    • 发送/接收功能
    • 交易状态监控
  • 安全功能:
    • 私钥管理
    • 交易验证
    • 速率限制
  • MCP集成:完全符合模型上下文协议

快速开始

  1. 克隆并安装

    cd solana-wallet-mcp
    npm install
    
  2. 配置环境

    cp .env.example .env
    # Edit .env with your configuration
    
  3. 启动MCP服务器

    npm run dev
    

MCP工具可用

钱包操作

  • get_wallet_balance -获取SOL和代币余额
  • get_wallet_info -获取全面的钱包信息
  • create_wallet -生成新的钱包密钥对

交易操作

  • send_sol -将SOL发送到另一个钱包
  • send_token -发送SPL令牌
  • get_transaction_history -检索交易历史记录
  • get_transaction_status -检查交易状态

实时监控

  • subscribe_wallet_changes -监控钱包的变化
  • get_recent_activity -获取最近的钱包活动

配置

在中配置您的Solana网络 config/networks.json:

{
  "mainnet": {
    "rpcUrl": "https://api.mainnet-beta.solana.com",
    "wsUrl": "wss://api.mainnet-beta.solana.com"
  },
  "devnet": {
    "rpcUrl": "https://api.devnet.solana.com",
    "wsUrl": "wss://api.devnet.solana.com"
  }
}

环境变量

SOLANA_NETWORK=devnet
SOLANA_RPC_URL=https://api.devnet.solana.com
SOLANA_WS_URL=wss://api.devnet.solana.com
MCP_SERVER_PORT=3000
LOG_LEVEL=info

安全说明

⚠️ 重要安全注意事项:

  • 切勿在日志或响应中公开私钥
  • 使用安全的密钥存储机制
  • 实施适当的速率限制
  • 彻底验证所有输入
  • 使用testnet/devnet进行开发

发展

# Development mode with hot reload
npm run dev

# Build for production
npm run build

# Run tests
npm test

# Lint code
npm run lint

浏览器支持

这是一个服务器端MCP实现,适用于:

  • 任何兼容MCP的AI助手
  • 克劳德桌面
  • 自定义MCP客户端

关于

Solana钱包MCP 通过模型上下文协议提供全面的Solana区块链钱包功能,使AI助手能够安全高效地执行实时钱包操作。

许可证

MIT许可证-有关详细信息,请参阅许可证文件。