CryptoQuant | On-chain intelligence, natively in your agent.

CryptoQuant MCP

通过 Model Context Protocol，为 AI Agent 提供 CryptoQuant 链上、市场和衍生品数据，以及 CryptoQuant Research 和 QuickTake 洞察。

此代码库包含：

• 远程服务配置，用于连接 https://mcp.cryptoquant.com/mcp（推荐；通过 OAuth 登录）
• Agent Plugins / Cursor 插件（plugin.json、mcp.json、skills/），用于连接远程服务，并指导 Agent 哪项指标可以回答哪个问题
• 本地 stdio 代理（npx cryptoquant-mcp），供无法连接远程 MCP 服务的客户端使用。它会将每条消息原样转发到远程服务。

远程服务（推荐）

服务 URL：https://mcp.cryptoquant.com/mcp（Streamable HTTP、OAuth）

配置中无需 API 密钥。首次连接时，客户端会打开 CryptoQuant 登录页面。更多配置详情：CryptoQuant 用户指南。

Claude（claude.ai 和 Claude Desktop）

打开 设置 → 连接器 → 添加自定义连接器，并粘贴服务 URL。

ChatGPT

添加使用服务 URL 的自定义连接器（开发者模式）。是否可用取决于你的 ChatGPT 计划。

Cursor

从 Cursor 市场安装 CryptoQuant 插件（上架后）。它会添加远程服务和 cryptoquant-onchain 技能。

或者在 .cursor/mcp.json（项目）或 ~/.cursor/mcp.json（全局）中自行添加服务：

{
  "mcpServers": {
    "cryptoquant": {
      "url": "https://mcp.cryptoquant.com/mcp"
    }
  }
}

VS Code

.vscode/mcp.json：

{
  "servers": {
    "cryptoquant": {
      "type": "http",
      "url": "https://mcp.cryptoquant.com/mcp"
    }
  }
}

Claude Code

claude mcp add --transport http cryptoquant https://mcp.cryptoquant.com/mcp

然后在 Claude Code 中运行 /mcp 登录。

本地安装（npx 代理）

适用于仅支持本地（stdio）服务的客户端。需要 Node.js 18+ 和 CryptoQuant API 密钥。

{
  "mcpServers": {
    "cryptoquant": {
      "command": "npx",
      "args": ["-y", "cryptoquant-mcp"],
      "env": {
        "CRYPTOQUANT_API_KEY": "your-api-key"
      }
    }
  }
}

应用	配置文件
Claude Desktop（macOS）	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop（Windows）	%APPDATA%\Claude\claude_desktop_config.json
Cursor	.cursor/mcp.json 或 ~/.cursor/mcp.json
Claude Code	项目中的 .mcp.json

变量	必需	描述
CRYPTOQUANT_API_KEY	是	你的 API 密钥，会作为 bearer token 发送到远程服务。如果未设置，则使用 0.x 保存于 ~/.cryptoquant/credentials 的密钥。
CRYPTOQUANT_MCP_URL	否	覆盖服务 URL（默认值为 https://mcp.cryptoquant.com/mcp）。必须使用 https；仅环回地址（localhost、127.0.0.1、[::1]）允许使用普通 http。

如果未提供密钥，代理会将配置说明打印到 stderr 并退出。

工具

这些工具来自远程服务。此列表仅供参考，可能会有变动。

工具	描述
discover_endpoints	按资产和类别查找数据端点
get_endpoint_info	获取端点参数（窗口、交易所、代币等）
query_data	查询链上、市场和衍生品数据
describe_metric	获取指标的定义、阈值和解读
list_assets	获取支持的资产
recent_research	获取最新的 CryptoQuant Research 文章
recent_quicktake	获取 CryptoQuant 认证作者发布的最新 QuickTake 文章
query_research	按主题搜索 Research 文章
query_quicktake	按主题搜索 QuickTake 文章

资产、日期和速率限制

• 资产： BTC、ETH、XRP、TRX、稳定币、ERC-20 代币及其他山寨币。list_assets 会返回当前列表。
• 日期： window=day 使用 yyyyMMdd（例如 20260115），其他窗口使用 yyyyMMddTHHmmss（例如 20260115T000000）。
• 速率限制和历史数据： 取决于你的 CryptoQuant 计划。连接时，服务会告知 Agent 你所用计划的限制。请参阅计划。

从 0.x 迁移

1.0 将 npm 包变为远程服务的代理，因此本地和远程服务现在提供相同的工具。

• initialize 和 reset_session 工具已移除。请改为在 MCP 配置中设置 CRYPTOQUANT_API_KEY。你在 0.x 中通过 initialize(api_key=...) 保存的密钥仍然有效；它会从 ~/.cryptoquant/credentials 读取。
• QuickTake 和 Research 工具现在可在本地使用。
• 该包不再导出 JavaScript 库 API。
• CRYPTOQUANT_API_URL（0.x 的 API 基础 URL 覆盖项）不再使用；如需指向其他 MCP 服务，请使用 CRYPTOQUANT_MCP_URL。
• npx -y cryptoquant-mcp 始终会获取最新版本，因此现有配置会在下次启动时切换到 1.0。调用 initialize 的提示词或工作流需要更新。

请参阅 CHANGELOG.md。

开发

git clone https://github.com/CryptoQuantOfficial/cryptoquant-mcp.git
cd cryptoquant-mcp
npm install
npm test
npm run build

请参阅 CONTRIBUTING.md。

许可证

MIT。请参阅 LICENSE。