article
README
🚀 MCP 阿波罗尼亚
本项目提供一个模型上下文协议 (MCP) 服务器,借助 Helius API 让 Claude 能够访问 Solana 区块链数据。通过该服务器,Claude 可以实现如查询钱包余额、获取区块链信息、与代币和 NFT 交互等操作。
🚀 快速开始
配置完成后,重启 Claude Desktop,Claude 即可访问 Solana 区块链工具。你可以向 Claude 提出如下需求:
- 检查钱包余额:
5YNmS1R9nNSCDzb5a7mMJ1dwK9uHeAAF4CmPEwKgVWr8 这个 Solana 钱包的余额是多少? - 获取当前区块高度:
Solana 的当前区块高度是多少? - 获取 NFT 信息:
钱包地址 5YNmS1R9nNSCDzb5a7mMJ1dwK9uHeAAF4CmPEwKgVWr8 拥有哪些 NFT?
Claude 将通过 MCP 服务器,利用 Helius 直接从 Solana 区块链获取所需信息。
✨ 主要特性
MCP 服务器为 Claude 提供了丰富多样的工具,涵盖基本区块链操作、代币操作、NFT 和数字资产、区块链系统信息以及交易和费用方法等多个方面:
基本区块链操作
helius_get_balance:获取 Solana 钱包地址的余额helius_get_block_height:获取 Solana 区块链的当前区块高度helius_get_slot:获取 Solana 区块链的当前槽helius_get_latest_blockhash:获取 Solana 区块链的最新区块哈希helius_get_transaction:通过签名获取交易信息helius_get_account_info:获取 Solana 地址的信息helius_get_signatures_for_address:获取与地址相关的交易签名helius_get_multiple_accounts:获取多个 Solana 账户的信息helius_get_program_accounts:获取由程序所有账户
代币操作
helius_get_token_accounts_by_owner:获取由 Solana 地址拥有的代币账户helius_get_token:获取代币信息helius_get_tokens_for_address:获取与地址相关的所有代币
NFT 和数字资产
helius_get_nfts_for_address:获取钱包地址的所有 NFThelius_get_nft_by_mint:通过铸造地址获取 NFT 信息
区块链系统信息
helius_get_block_time:获取区块时间信息
交易和费用方法
helius_get_fee_calculator_for_blockhash:根据区块哈希获取费用计算器helius_get_recent_blockhashes:获取最近的区块哈希列表
📦 安装指南
先决条件
- Node.js:版本要求为 14.0 或更高
- Helius API 密钥:免费注册 Solana Devnet 获取
- Claude Desktop 应用程序
安装步骤
git clone https://github.com/dcspark/mcp-helius.git
cd mcp-helius
npm install
📚 详细文档
配置
添加到Claude配置文件
在 ~/.config/claude/v2/tools.json 文件中添加以下内容:
{
"mcp-helius": {
"_comment": "MCP Helius 提供 Solana 区块链工具",
"schemaVersion": "1.0.0",
"version": "1.0.0",
"cli": {
"command": "node build/index.js"
},
"development": {
"sourceFile": "src/index.ts"
}
}
}
本地运行
HELIUS_API_KEY=your-helius-api-key node build/index.js
你也可以直接使用 npx 运行:
HELIUS_API_KEY=your-helius-api-key npx @dcspark/mcp-helius
开发
添加新工具
若要在 MCP 服务器中添加新的工具,可按以下步骤操作:
- 在
src/tools.ts中定义工具 - 在适当的处理器文件中创建相应的处理函数
- 将处理器添加到
src/tools.ts中的handlers对象
构建
npm run build
📄 许可证
本项目采用 MIT 许可证。
微信扫一扫