关键词

加密货币数据区块链项目RootData APIAI助手Claude

使用说明

项目简介

RootData MCP Server 是一个实现了 Model Context Protocol (MCP) 的后端服务器，旨在为大型语言模型（LLM）客户端，如 Claude，提供访问加密货币和区块链项目数据的能力。通过此服务器，LLM 可以调用预设的工具来查询 RootData API，获取项目、机构和人物的相关信息，从而增强 LLM 在区块链领域的知识和应用能力。

主要功能点

  • 数据查询工具: 提供 'search', 'get_project', 'get_organization' 三个工具，分别用于搜索项目/机构/人物简要信息、获取项目详细信息和获取机构详细信息。这些工具允许 LLM 客户端通过自然语言指令，间接调用 RootData API 获取数据。
  • MCP 协议支持: 完全遵循 Model Context Protocol 协议，能够处理 MCP 客户端发送的符合协议规范的请求，并返回标准的 JSON-RPC 响应。
  • 易于集成: 提供了详细的安装和配置步骤，特别是针对 Claude Desktop 的集成指南，使得用户可以快速将此 MCP 服务器与 Claude 等客户端连接。
  • 灵活部署: 使用 Python 和 FastMCP 框架开发，易于部署和扩展，支持通过环境变量配置 API 密钥，保证安全性。

安装步骤

  1. 克隆仓库

    git clone https://github.com/jincai/rootdata-mcp-server
cd rootdata-mcp-server

  2. 安装 uv (推荐) 或 pip 推荐使用 'uv' 包管理器，如果尚未安装，请根据 README.md 中的指引安装。或者，您也可以使用 'pip'。

  3. 创建并激活虚拟环境 使用 'uv':

    uv venv
source .venv/bin/activate  # Linux/macOS
.venv\Scripts\activate  # Windows

    或者使用 'pip':

    python3 -m venv .venv
source .venv/bin/activate  # Linux/macOS
.venv\Scripts\activate  # Windows

  4. 安装依赖 使用 'uv':

    uv add "mcp[cli]" httpx python-dotenv

    或者使用 'pip':

    pip install "mcp[cli]" httpx python-dotenv

  5. 配置 API 密钥 复制 '.env.example' 文件并重命名为 '.env'，然后编辑 '.env' 文件，将 'your-rootdata-api-key' 替换为您的 RootData API 密钥。

    cp .env.example .env
# 编辑 .env 文件，填入 API 密钥

  6. 运行服务器 使用 'uv':

    uv run server.py

    或者使用 'pip':

    python server.py

    服务器默认使用 stdio 传输协议。

服务器配置 (Claude Desktop)

要将此 MCP 服务器连接到 Claude Desktop，您需要编辑 Claude Desktop 的配置文件 'claude_desktop_config.json'。

配置文件路径 (macOS): '~/Library/Application\ Support/Claude/claude_desktop_config.json'

配置内容:

{
  "mcpServers": {
    "rootdata": { // 服务器名称，可以自定义
      "command": "/path/to/uv", // uv 命令的绝对路径，可以使用 'which uv' 命令查找
      "args": [
        "--directory",
        "/absolute/path/to/rootdata-mcp-server", // rootdata-mcp-server 仓库的绝对路径
        "run",
        "server.py"
      ]
    }
  }
}

参数说明:

  • '"rootdata"': MCP 服务器的名称，在 Claude Desktop 工具菜单中显示。您可以自定义此名称。
  • '"command"': 启动 MCP 服务器的命令。这里配置为 'uv' 包管理器，你需要将其替换为 'uv' 命令的实际绝对路径。可以使用 'which uv' 命令在终端中查找 'uv' 的路径。如果使用 'pip' 运行 'server.py'，则 'command' 可以配置为 Python 解释器的路径，例如 '"/usr/bin/python3"' 或 '"/path/to/python3"'。
  • '"args"': 传递给 'command' 命令的参数列表。
    • '"directory"': 指定工作目录为 'rootdata-mcp-server' 仓库的绝对路径。请将 '/absolute/path/to/rootdata-mcp-server' 替换为您的实际仓库路径。
    • '"run"': 'uv run' 的子命令，用于运行 Python 脚本。
    • '"server.py"': 要运行的服务器脚本文件名。

注意:

  • 请确保将 '/path/to/uv' 替换为 'uv' 命令的实际路径，将 '/absolute/path/to/rootdata-mcp-server' 替换为 'rootdata-mcp-server' 仓库在您本地文件系统中的绝对路径。
  • 如果您不使用 'uv'，而是直接使用 'python server.py' 运行服务器，则需要相应地修改 'command' 和 'args' 配置。例如，'command' 可以是 Python 解释器的路径，'args' 可以简化为 '["server.py"]'，并移除 '--directory' 参数，确保 Claude Desktop 能够正确找到并执行 'server.py' 脚本。

基本使用方法

  1. 启动 RootData MCP Server 后，重启 Claude Desktop。

  2. 在 Claude Desktop 中，点击工具菜单（通常是锤子图标），您应该能看到名为 "rootdata" (或您在配置文件中设置的名称) 的工具组。

  3. 在 Claude 中提问，可以使用自然语言指令来调用 RootData 工具，例如：

    • "搜索以太坊相关的项目" (调用 'search' 工具)
    • "获取项目 ID 为 12 的详细信息" (调用 'get_project' 工具)
    • "查询机构 ID 为 219 的风投机构信息" (调用 'get_organization' 工具)

    Claude 会解析您的指令，并调用相应的 RootData 工具来获取数据，并将结果返回给您。

信息

分类

网页与API

访问项目