🚀 MCP 阿波罗尼亚

此项目包含一个模型上下文协议 (MCP) 服务器，借助 Helius API 为 Claude 提供访问 Solana 区块链数据的能力。通过该服务器，Claude 能够进行多种操作，如查询钱包余额、获取区块链信息以及与代币和 NFT 进行交互，为区块链数据的获取和利用提供了便捷途径。

🚀 快速开始

本项目旨在通过 MCP 服务器为 Claude 提供访问 Solana 区块链数据的能力。在开始使用前，请确保满足先决条件，并按照安装和配置步骤进行操作，之后即可让 Claude 访问 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：获取钱包地址的所有 NFT
• helius_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

使用说明

配置完成后，重启 Claude Desktop。现在 Claude 可以访问 Solana 区块链工具了。你可以要求 Claude 执行以下操作：

1. 检查钱包余额：

   5YNmS1R9nNSCDzb5a7mMJ1dwK9uHeAAF4CmPEwKgVWr8 这个 Solana 钱包的余额是多少？
   

2. 获取当前区块高度：

   Solana 的当前区块高度是多少？
   

3. 获取 NFT 信息：

   钱包地址 5YNmS1R9nNSCDzb5a7mMJ1dwK9uHeAAF4CmPEwKgVWr8 拥有哪些 NFT？
   

Claude 将使用 MCP 服务器通过 Helius 直接从 Solana 区块链获取这些信息。

开发

添加新工具

要在 MCP 服务器中添加新的工具：

1. 在 src/tools.ts 中定义工具
2. 创建相应的处理函数在适当的处理器文件中
3. 将处理器添加到 src/tools.ts 中的 handlers 对象

构建

npm run build

📄 许可证

本项目采用 MIT 许可证。