Solana Agent Kit

🚀 Solana Agent Kit MCP 服务器

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

🚀 快速开始

此 MCP 服务器扩展了 Claude 的能力，能让其与 Solana 区块链进行交互、执行交易、查询账户信息以及管理 Solana 钱包。服务器实现了模型上下文协议规范，以标准化 AI 代理的区块链互动。

✨ 主要特性

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

📦 安装指南

先决条件

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

安装步骤

选项 1：从 npm 安装（推荐）

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

# 或者在项目中本地安装
npm install solana-mpc

选项 2：从源代码构建

1. 克隆此仓库：

git clone https://github.com/sendaifun/solana-mcp-server
cd solana-mcp-server

2. 安装依赖项：

pnpm install

3. 构建项目：

pnpm run build

📚 详细文档

配置

环境设置

创建一个 .env 文件，包含你的凭证：

# Solana 配置
SOLANA_RPC_URL=http://localhost:8899  # 根据实际情况修改地址
SOLANA_WS_URL=ws://localhost:8899    # 根据实际情况修改地址

集成到 Claude Desktop

要将 MCP 服务器集成到 Claude Desktop，请按照以下步骤操作：

1. 打开 Claude Desktop。
2. 转到“设置”菜单。
3. 选择“插件”或“扩展”部分。
4. 添加 MCP 插件的路径或 ID。
5. 配置插件所需的参数，如 RPC URL 和钱包地址。

项目结构

项目的基本结构如下：

project-root/
├── src/                 # 源代码目录
│   ├── server.ts       # 主服务器文件
│   └── plugins/        # 插件目录
├── .env                # 环境变量文件
└── package.json        # 项目依赖和脚本

可用工具

以下是 MCP 服务器提供的主要功能：

• getBalance：查询指定地址的余额。
• sendTransaction：执行转账交易。
• createAccount：创建新的 Solana 账户。
• signMessage：对消息进行签名。

安全注意事项

在使用此服务器时，请注意以下安全事项：

• 确保你的私钥安全，避免泄露。
• 使用测试网进行开发和测试，避免误操作影响主网。
• 定期审查和审计 AI 代理的操作日志。
• 考虑为每个代理创建专用钱包。

故障排除

遇到问题时，请执行以下步骤：

1. 验证 Solana 私钥是否正确。
2. 检查 RPC URL 是否有效。
3. 确保你在正确的网络（主网、测试网或开发网）上操作。
4. 查看 Claude Desktop 的日志以获取错误信息。
5. 确认构建过程顺利完成。

依赖项

主要依赖包括：

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

贡献指南

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

1. 叉克隆仓库
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 许可证。