Solana区块链交互工具

一个基于Model Context Protocol (MCP)的服务,为Claude AI提供与Solana区块链交互的工具,包括执行交易、查询账户信息和管理钱包等功能。

  • by GoInfinitely
  • Shell
  • 本地部署
  • 更新于
在 GitHub 查看 GoInfinitely/solana-mcp

使用说明

Solana代理套件MCP服务器

检查Phala

一个模型上下文协议(MCP)服务器,为Claude AI提供链上工具,使其能够通过标准化接口与Solana区块链进行交互。此实现基于Solana Agent Kit,使AI代理能够无缝执行区块链操作。

概述

此MCP服务器通过提供以下工具扩展了Claude的功能:

  • 与Solana区块链互动
  • 执行交易
  • 查询账户信息
  • 管理Solana钱包

服务器实现了模型上下文协议规范,以标准化AI代理的区块链交互。

先决条件

  • Node.js(v16或更高版本)
  • pnpm(推荐)、npm或yarn
  • 带私钥的Solana钱包
  • Solana RPC URL(主网、测试网或开发网)

安装

选项1:快速安装(推荐)

# Download the installation script
curl -fsSL https://raw.githubusercontent.com/sendaifun/solana-mcp/main/scripts/install.sh -o solana-mcp-install.sh

# Make it executable and run
chmod +x solana-mcp-install.sh && ./solana-mcp-install.sh --backup

这将启动一个交互式安装过程,引导您完成以下步骤:

  • 如果需要,设置Node.js
  • 配置Solana RPC URL和私钥
  • 设置Claude Desktop集成

选项2:从npm安装(推荐给Cursor/Cline等客户端)

# Install globally
npm install -g solana-mcp

# Or install locally in your project
npm install solana-mcp

选项3:从源代码构建

  1. 克隆此存储库:
git clone https://github.com/sendaifun/solana-mcp
cd solana-mcp
  1. 安装依赖项:
pnpm install
  1. 构建项目:
pnpm run build

配置

环境设置

创建一个 .env 使用您的凭据文件:

# Solana Configuration
SOLANA_PRIVATE_KEY=your_private_key_here
RPC_URL=your_solana_rpc_url_here
OPENAI_API_KEY=your_openai_api_key # OPTIONAL

与Claude Desktop集成

要将此MCP服务器添加到Claude Desktop,请执行以下步骤:

  1. 找到Claude桌面配置文件

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json
  2. 添加配置 创建或编辑配置文件,并添加以下JSON:

    如果你是通过npm安装的(选项1):

    {
      "mcpServers": {
        "solana-mcp": {
          "command": "npx",
          "args": ["solana-mcp"],
          "env": {
            "RPC_URL": "your_solana_rpc_url_here",
            "SOLANA_PRIVATE_KEY": "your_private_key_here",
            "OPENAI_API_KEY": "your_openai_api_key"  // OPTIONAL
          },
          "disabled": false,
          "autoApprove": []
        }
      }
    }
    

    如果您从源代码构建(选项2):

    {
      "mcpServers": {
        "solana-mcp": {
          "command": "node",
          "args": ["/path/to/solana-mcp/build/index.js"],
          "env": {
            "RPC_URL": "your_solana_rpc_url_here",
            "SOLANA_PRIVATE_KEY": "your_private_key_here",
            "OPENAI_API_KEY": "your_openai_api_key"  // OPTIONAL
          },
          "disabled": false,
          "autoApprove": []
        }
      }
    }
    
  3. 重新启动克劳德桌面 进行这些更改后,重新启动Claude Desktop以使配置生效。

项目结构

solana-agent-kit-mcp/
├── src/
│   ├── index.ts          # Main entry point
├── package.json
└── tsconfig.json

可用工具

MCP服务器提供以下Solana区块链工具:

  • GET_ASSET -检索有关Solana资产/令牌的信息
  • DEPLOY_TOKEN -在Solana上部署新令牌
  • GET_PRICE -获取代币的价格信息
  • WALLET_ADDRESS -获取钱包地址
  • BALANCE -检查钱包余额
  • TRANSFER -在钱包之间转移代币
  • MINT_NFT -创建和创建新的NFT
  • TRADE -执行代币交易
  • REQUEST_FUNDS -申请资金(可用于测试/开发)
  • RESOLVE_DOMAIN -解析Solana域名
  • GET_TPS -获取Solana上每秒的当前交易量

安全注意事项

  • 确保您的私钥安全,切勿共享
  • 对敏感信息使用环境变量
  • 考虑使用专用钱包进行AI代理操作
  • 定期监控和审计AI代理活动
  • 在主网之前在devnet/testnet上进行测试操作

故障排除

如果您遇到问题:

  1. 验证您的Solana私钥是否正确
  2. 检查您的RPC URL是否可访问
  3. 确保您在预期的网络(主网、测试网或开发网)上
  4. 检查Claude Desktop日志中的错误消息
  5. 验证构建是否成功

依赖项

关键依赖关系包括:

贡献

欢迎投稿!请随时提交拉取请求。

  1. 复刻仓库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add some amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

许可证

该项目根据MIT许可证获得许可。