使用说明

项目简介

Hubble AI MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 应用提供访问 Solana 区块链数据的能力和数据可视化功能。通过集成 Hubble AI 的分析工具，该服务器允许 LLM 客户端以标准化的方式查询链上交易数据、分析代币信息，并生成各种图表进行数据可视化。

主要功能点

Solana 数据查询: 提供工具使 LLM 能够查询 Solana 区块链上的数据，例如最新交易、代币价格、持币人信息和交易模式等。
数据可视化: 集成图表生成工具，支持 LLM 根据查询结果生成多种类型的图表，如柱状图、折线图、饼图等，用于数据可视化分析。
工具注册与执行: 实现了 MCP 协议的工具注册和执行功能，允许 LLM 客户端调用预定义的工具来完成特定的数据查询和图表生成任务。
标准 MCP 协议: 基于 '@modelcontextprotocol/sdk' 开发，遵循 MCP 协议标准，确保与 MCP 客户端的兼容性。
Stdio 传输协议: 使用 Stdio 作为默认传输协议，方便集成和部署。

安装步骤

安装 Hubble AI MCP Server 工具: 此仓库本身是 MCP 服务器的实现，无需额外安装步骤。通常，此 MCP 服务器会作为 LLM 应用的后端服务运行。
配置 MCP 客户端: 在您的 MCP 客户端应用中，配置 Hubble AI MCP Server 的连接信息。

服务器配置

要将 Hubble AI MCP Server 集成到 MCP 客户端，您需要在客户端的配置文件中添加服务器信息。以下是一个示例配置，您需要根据您的实际部署环境进行调整：

{
  "mcpServers": {
    "hubble-tool": {  // 服务器名称，客户端通过此名称引用
      "command": "npx",  // 启动服务器的命令，这里假设使用 npx 运行
      "args": ["-y", "hubble-ai-mcp/src/index.ts"] // 启动参数，指向 Hubble AI MCP Server 的入口文件
      // 假设 hubble-ai-mcp 仓库代码在客户端项目的子目录中，根据实际路径调整
    }
  }
}

配置参数说明:

'server name': 'hubble-tool' - 您为该 MCP 服务器指定的名称，在客户端配置中用于标识和引用此服务器。
'command': 'npx' - 用于启动 Node.js 应用的命令，前提是您的环境中已安装 Node.js 和 npm。如果全局安装了 'hubble-ai-mcp' 包，则可以直接使用包名作为 command。
'args': '["-y", "hubble-ai-mcp/src/index.ts"]' - 传递给 'command' 的参数，用于指定要执行的服务器入口文件路径。请根据实际情况修改 'hubble-ai-mcp/src/index.ts' 为服务器入口文件的相对或绝对路径。 '-y' 参数用于 'npx' 自动安装依赖。

注意: 以上配置假设您使用 'npx' 直接运行服务器代码。在实际部署中，您可能需要先构建项目，并使用 'node' 命令运行构建后的 JavaScript 文件。

基本使用方法

启动 Hubble AI MCP Server: 根据您配置的启动命令和参数，在服务器端启动 Hubble AI MCP Server。
配置并启动 MCP 客户端: 确保您的 MCP 客户端已正确配置 Hubble AI MCP Server 的连接信息，并启动客户端应用。
LLM 应用交互: 在您的 LLM 应用中，可以使用自然语言指令来查询 Solana 数据或生成图表。客户端会将这些请求转换为 MCP 协议请求，发送给 Hubble AI MCP Server。
接收响应: Hubble AI MCP Server 处理请求后，会将结果以 MCP 协议响应的形式返回给客户端，客户端再将结果呈现给 LLM 应用或用户。

示例查询:

"Show me the latest blockchain transactions" (查询最新区块链交易)
"What is the current token price?" (查询当前代币价格)
"Generate a chart of transaction volume for the last week" (生成过去一周交易量图表)

请参考 Hubble AI MCP Server 提供的工具定义和参数，构建您的 LLM 应用查询。

关键词