Skip to main content
Glama
CyberQuant MCP Server

CyberQuant MCP Server

by slb-cn

CyberQuant MCP Server

Node.js >= 20 License: MIT MCP Protocol

CyberQuant 数据共享平台的 MCP(Model Context Protocol)服务器,让 AI 助手(Claude Desktop、ChatGPT 等)能够直接查询和分析金融数据。

工作方式:AI 客户端通过 stdio 与 MCP Server 通信,MCP Server 再向 API Gateway 拉取数据,以 AI 友好的 CSV 格式返回。

功能特性

MCP Tools(7 个)

工具

说明

configure

配置 API Key,首次使用时调用

list_routes

列出当前用户可用的数据路由目录(仅元信息,不含入参/返回字段)

get_route_detail

查询单个路由的入参/返回字段详情,由大模型据此自行组织 query_data 参数

query_data

查询指定数据路由的数据,返回 CSV 格式(节省 token)

get_routes_metadata

查询当前用户可访问的数据路由元数据列表,返回压缩 JSON

get_user_profile

查询当前 API Key 对应用户的账户与权限信息,返回压缩 JSON

clear_routes_cache

清除本地路由元数据按日缓存,当日权限/路由变动后强制下次查询重新拉取最新元数据

MCP Resources(2 个)

资源 URI

说明

cyberquant://user/profile

当前用户信息(等级、市场权限、速率限制)

cyberquant://routes

当前用户可用的数据路由列表

设计亮点

  • CSV 输出:相比 JSON 节省 40–60% token,表格结构天然适合 AI 分析

  • 路由目录 + 按需详情:list_routes 仅输出目录级元信息,get_route_detail 按需取详情,避免上百路由全量入参一次性占满上下文(路由元数据按账号按日文件缓存,减少重复拉取)

  • Resource 兼容工具:get_routes_metadata 与 get_user_profile 让无法稳定读取 MCP Resources 的 AI 助手也能主动获取完整上下文

  • 自然语言引导:数据返回附带提示,引导 AI 缩小查询范围而非暴力翻页

  • pageSize 上限保护:超过 1000 条自动拦截,避免 AI 处理超大数据集

  • 运行时配置:通过 configure 工具动态更新 API Key,无需重启

Related MCP server: FinClaw

快速开始

环境要求

  • Node.js >= 20.0.0

1. 接入 MCP 客户端

在 Claude Desktop(或任意 MCP 客户端)的配置文件中添加:

  • macOS:~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows:%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "cyberquant": {
      "command": "npx",
      "args": ["-y", "cyberquant-mcp"]
    }
  }
}

保存后重启客户端即可。> 从源码本地构建运行的方式见 CONTRIBUTING.md。

2. 配置 API Key

MCP Server 与 cyberquant-cli 共用配置文件 ~/.cyberquant/config.json:

{
  "endpoint": "https://api.cyberspace2077.com",
  "apiKey": "sk_live_your_api_key_here",
  "mcp": {
    "pageSize": 200,
    "timeout": 30000
  }
}

💡 也可不手动编辑文件——启动后在对话中直接说"请配置我的 API Key",AI 会调用 configure 工具完成配置;pageSize 同样可在对话中通过 configure 设置(省略则保留现有值)。

完整字段说明见 配置文档。

3. 开始使用

在对话中直接提问,例如:

帮我查一下平安银行最近一周的日K线数据

AI 会依次调用 list_routes → get_route_detail → query_data,并以表格形式返回分析结果。更多场景见 使用示例。

文档

文档

说明

配置说明

配置文件格式与字段说明

工具说明

MCP Tools 的详细文档

Resources 说明

MCP Resources 介绍

故障排查

常见问题与解决方案

使用示例

典型对话场景

贡献

参与开发、构建或发布请参考 CONTRIBUTING.md。

License

MIT

Available Tools

7 tools
clear_routes_cacheA

清除本地路由元数据按日缓存(~/.cyberquant/cache/routes-.json)。仅当用户当日权限/可访问路由发生变动、当日缓存未自动刷新时使用,强制下次查询重新从 API 拉取最新元数据。不发起网络请求。

Inputs: no named parameters.

configureA

配置 API Key 以访问数据服务,配置文件位于 /.cyberquant/config.json。不传任何参数时为「查询配置状态」(只读,返回是否已配置/endpoint/pageSize,不回显密钥、不写文件);传入任意参数则为「写入配置」——apiKey 首次必填,配置文件已有 apiKey 时可省略(保留现有值);endpoint 默认 https://api.cyberspace2077.com,通常无需传入;pageSize 可选(11000),省略则保留现有配置值。

Inputs: apiKey, endpoint, pageSize.

get_route_detailA

查询单个路由的入参与返回字段详情,并附带通用传值格式说明。

Inputs: routeSlug (required).

get_routes_metadataA

一次性返回所有路由的完整元数据(压缩 JSON,含 routeSlug、名称、说明、分类、市场类型、权限等级、queryParams、responseParams)。token 开销较大,仅当需要一次性拿到全部接口的完整字段定义、构建完整索引时使用。

Inputs: no named parameters.

get_user_profileA

查询当前 API Key 的账户与权限信息(压缩 JSON):邮箱、订阅等级、可用市场、到期时间、账户是否有效、速率限制配置。仅在需要核对账户状态、可用市场范围或查看限流配额时调用。

Inputs: no named parameters.

list_routesA

列出当前用户可用的数据路由目录(轻量,仅 routeSlug、名称、说明、分类,不含入参/返回字段)。

Inputs: no named parameters.

query_dataA

按参数查询指定路由的数据,返回 CSV 格式。需先用 get_route_detail 获取入参/返回字段说明,再据此组织 params 调用本工具。

Inputs: routeSlug (required), params.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: configuration, listing routes, getting route details, querying data, bulk metadata, user profile, cache clearing. No overlapping functionality.

    Naming Consistency4/5

    Most tools follow verb_noun pattern (list_routes, get_route_detail, query_data, etc.), but 'configure' is a single verb without a noun, causing a slight inconsistency.

    Tool Count5/5

    7 tools is well within the ideal 3-15 range. The count feels appropriate for a data query API server without being too heavy or too light.

    Completeness5/5

    The tool set covers the full lifecycle: setup (configure), discovery (list_routes, get_route_detail, get_routes_metadata), query (query_data), account info (get_user_profile), and maintenance (clear_routes_cache). No obvious gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that provides AI agents with real-time access to DEX liquidity pool data, enabling smarter trading, analytics, and automated strategies.
      10
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that provides AI agents with financial tools including real-time quotes, backtesting, technical analysis, and multi-exchange data via a simple CLI interface.
      2
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      MCP server that exposes QuantXData's institutional crypto market data APIs to AI assistants, enabling natural language queries for trades, order books, OHLCV, options, and more across 120+ exchanges.
      12
      MIT