Solana Agent Kit MCP 服务器

一个模型上下文协议 (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

2. 安装依赖项:

pnpm install

3. 构建项目:

pnpm run build

配置

环境设置

创建一个包含您的凭据的 .env 文件:

# Solana 配置
SOLANA_PRIVATE_KEY=your_private_key_here
RPC_URL=your_solana_rpc_url_here
OPENAI_API_KEY=your_openai_api_key # 可选

与 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": "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 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 代理活动
• 在主网上进行操作之前，先在 devnet/testnet 上进行测试

故障排除

如果您遇到问题：

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

依赖项

主要依赖项包括：

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

贡献

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

1. Fork 存储库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

许可证

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