Solana Agent Kit MCP 服务器

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

概览

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

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

该服务器实现了 Model Context Protocol 规范，以标准化 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
   • 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": "your_solana_rpc_url_here",
           "SOLANA_PRIVATE_KEY": "your_private_key_here",
           "OPENAI_API_KEY": "your_openai_api_key"  // 可选
         },
         "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"  // 可选
         },
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   

3. 重启 Claude 桌面
   进行这些更改后，重启 Claude 桌面以使配置生效。

项目结构

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 桌面日志中的错误消息
5. 确认构建成功

依赖项

关键依赖项包括：

• @solana/web3.js
• @modelcontextprotocol/sdk
• solana-agent-kit

贡献

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

1. Fork 仓库
2. 创建你的功能分支 (git checkout -b feature/amazing-feature)
3. 提交你的更改 (git commit -m '添加一些惊人的功能')
4. 将更改推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

许可证

本项目使用 MIT 许可证。