返回市场
索拉纳-MCP

索拉纳-MCP

作者:sendaifun134 星标更新:2025-05-21

项目介绍

Solana Agent Kit MCP 服务器

npm 版本 许可证: ISC <a href="https://cloud.phala.network/features/mcp-hosting/solana-mcp-by-sendai-and-dark" target="_blank" rel="noopener noreferrer" style="display:inline-flex;align-items:center;text-decoration:none;background:#fff;border:1px solid #e5e7eb;border-radius:6px;padding:2px 8px;font-size:16px;font-family:sans-serif;"> <img src="https://gips2.baidu.com/it/u=1203000750,3568942508&fm=3081&app=3081&f=PNG?w=360&h=360" alt="Phala Logo" height="24" style="vertical-align:middle;margin-right:8px;"/> <span style="color:#222;font-weight:600;">在 Phala 上查看</span> </a>

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

概述

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

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

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

先决条件

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

安装

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

# 下载安装脚本
curl -fsSL https://raw.githubusercontent.com/sendaifun/solana-mcp/main/scripts/install.sh -o solana-mcp-install.sh

# 赋予可执行权限并运行
chmod +x solana-mcp-install.sh && ./solana-mcp-install.sh --backup

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

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

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

# 全局安装
npm install -g solana-mcp

# 或者在项目中本地安装
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 配置
SOLANA_PRIVATE_KEY=您的私钥
RPC_URL=您的 Solana RPC URL
OPENAI_API_KEY=您的 OpenAI API 密钥 # 可选

与 Claude Desktop 集成

要将此 MCP 服务器添加到 Claude Desktop,请按照以下步骤操作:

  1. 定位 Claude Desktop 配置文件

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %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": "您的 Solana RPC URL",
            "SOLANA_PRIVATE_KEY": "您的私钥",
            "OPENAI_API_KEY": "您的 OpenAI API 密钥"  // 可选
          },
          "disabled": false,
          "autoApprove": []
        }
      }
    }
    

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

    {
      "mcpServers": {
        "solana-mcp": {
          "command": "node",
          "args": ["/path/to/solana-mcp/build/index.js"],
          "env": {
            "RPC_URL": "您的 Solana RPC URL",
            "SOLANA_PRIVATE_KEY": "您的私钥",
            "OPENAI_API_KEY": "您的 OpenAI API 密钥"  // 可选
          },
          "disabled": false,
          "autoApprove": []
        }
      }
    }
    
  3. 重启 Claude Desktop 在做出这些更改后,重启 Claude Desktop 以使配置生效。

项目结构

solana-agent-kit-mcp/
├── src/
│   ├── index.ts          # 主入口点
├── 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 代理活动
  • 在主网上线之前,在开发网/测试网上测试操作

故障排除

如果您遇到问题:

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

依赖项

关键依赖项包括:

贡献

欢迎贡献!请随意提交拉取请求。

  1. 分叉仓库
  2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
  3. 提交您的更改 (git commit -m '添加一些精彩的功能')
  4. 推送到分支 (git push origin feature/amazing-feature)
  5. 打开拉取请求

许可证

本项目采用 MIT 许可证。