金融数据，为 agent context 而生 — 不是给人看的，是给 agent 用的。

目录

• 这是什么
• 可用工具
• 试一试
• 一键安装（Prompt）
• 接入方式
• Remote / Hosted MCP
• 环境变量
• 路线图
• 另请参阅
• 贡献
• License

这是什么

LLMQuant Data 的 MCP server。通过 Model Context Protocol 把金融数据（百科、论文、行情、宏观指标、SEC 财报等）接入任何 AI agent。

配置一次，所有 agent 环境直接可用。

[!TIP] 我们还在做 llmquantdata-skills — 把这些数据工具串成现成的金融工作流（个股研究、宏观分析等），开箱即用。

可用工具

[!NOTE] Credit 计费目前处于 beta，下表额度可能调整。在 llmquantdata.com 注册即送免费 credits，不用绑卡。

| 工具 | 说明 | Credit | |------|------|--------| | wiki_search | 语义搜索 50,000+ 量化百科词条 | 1 | | wiki_read | 按 ID 读取百科词条 | 0 | | paper_search | 语义搜索 1,200+ 研究论文 | 1 | | paper_read | 按章节读取论文（摘要、方法、结论等） | 0 | | crypto_historical_klines | 加密货币历史 K 线（Binance 现货） | 1 | | crypto_snapshot | 加密货币实时价格 + 24h 统计 | 1 | | equity_historical_prices | 美股日线 OHLCV + 分红/拆股 | 1 | | etf_lookup | ETF 基本信息 + SEC 映射 + top holdings 摘要（当前覆盖的 SEC-backed universe） | 0 | | etf_holdings | ETF 最近可用 SEC N-PORT 监管持仓（当前覆盖的 SEC-backed universe） | 1* | | macro_indicator_search | 浏览 50+ 精选宏观指标（FRED 等） | 0 | | macro_indicator_history | 查询宏观指标历史数据 | 1 | | macro_indicator_snapshot | 获取宏观指标最新值 | 1 | | sec_filing_browse | 浏览 SEC 10-K / 10-Q 财报元数据 | 0 | | sec_filing_read | 读取 SEC 财报章节正文 | 1 | | sec_13f_list_manager_holdings | 列出某机构最新季度 13F 持仓（覆盖 Top 1000 × 最近 4 季度） | 1 | | sec_13f_list_ticker_holders | 列出持有某 ticker 的机构（覆盖 Top 1000 × 最近 4 季度） | 1 | | sec_13f_list_top_managers | 按 13F reportable value 列出 Top N smart money 机构（最新季度，最多 1000） | 1 |

更多数据（新闻、公司基本面、earnings call 等）见路线图。

每种数据支持四种查询方式：

试一试

用 MCP Inspector 在浏览器里交互测试：

export LLMQUANT_API_KEY=your_api_key
npx @modelcontextprotocol/inspector npx -y @llmquant/data-mcp

[!NOTE] 想持久化 key，把 export LLMQUANT_API_KEY=your_api_key 加到 ~/.zshrc 或 ~/.bashrc。

[!TIP] 需要 API key — 在 llmquantdata.com 免费注册。

一键安装（Prompt）

最快的方式：把下面这段 prompt 丢进 Claude Code / Cursor / Codex CLI / Gemini CLI / 任意支持 MCP 的 agent。Agent 会读这份 README 然后按它当前 runtime 的配置跑安装。

Install the LLMQuant data-mcp server in this environment by following https://github.com/LLMQuant/data-mcp

[!TIP] 确保 agent 运行的 shell 里已经 export LLMQUANT_API_KEY=...。免费 key 在 llmquantdata.com 注册即得。

更想手动配置？看下面的 接入方式。

接入方式

Claude Code

claude mcp add llmquant-data \
  -e LLMQUANT_API_KEY=your_api_key \
  -- npx -y @llmquant/data-mcp

Cursor

写入 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）：

{
  "mcpServers": {
    "llmquant-data": {
      "command": "npx",
      "args": ["-y", "@llmquant/data-mcp"],
      "env": {
        "LLMQUANT_API_KEY": "your_api_key"
      }
    }
  }
}

Codex CLI

codex mcp add llmquant-data \
  --env LLMQUANT_API_KEY=your_api_key \
  -- npx -y @llmquant/data-mcp

Gemini CLI

gemini mcp add -s user \
  -e LLMQUANT_API_KEY=your_api_key \
  llmquant-data \
  -- npx -y @llmquant/data-mcp

其他 MCP 客户端

支持 stdio 的客户端都能用这段配置：

{
  "mcpServers": {
    "llmquant-data": {
      "command": "npx",
      "args": ["-y", "@llmquant/data-mcp"],
      "env": {
        "LLMQUANT_API_KEY": "your_api_key"
      }
    }
  }
}

[!NOTE] 更多客户端的接入指南在补充中。你用的框架没列出来？提个 Issue，我们来加。

Remote / Hosted MCP

@llmquant/data-mcp 本地仍默认走 stdio。部分 LLMQuant 账号也可以在 Dashboard 里生成 hosted Remote MCP connector URL；适合支持远程 connector、且不想在本地运行 Node.js 进程的 MCP 客户端。

Claude custom connectors

在 LLMQuant Dashboard 的 Connect 里生成 Remote MCP URL：

https://mcp.llmquantdata.com/u/lqd_mcp_.../mcp

把完整 URL 粘到 Claude custom connector。Hosted URL 和本地 LLMQUANT_API_KEY 是分开的，可以在 Dashboard 里单独 revoke。

[!IMPORTANT] 请把 hosted connector URL 当作密码保存。任何拿到 URL 的人都可以使用这个 connector，直到你 revoke 它。

环境变量

| 变量 | 必填 | 默认值 | 说明 | |------|------|--------|------| | LLMQUANT_API_KEY | stdio 必填 | — | 本地 stdio 模式用的用户 API key | | LLMQUANT_BASE_URL | 否 | https://api.llmquantdata.com | API 地址 | | LLMQUANT_API_TIMEOUT_MS | 否 | 15000 | 请求超时，毫秒（最大 120000） |

路线图

• [x] Streamable HTTP transport（不装 Node.js 也能远程用）
• [ ] Claude Connectors Directory OAuth 流程
• [ ] 更多数据 — 新闻、公司基本面、earnings call
• [ ] Agent skills 配套包（llmquantdata-skills）
• [ ] 更多 agent 框架接入指南

有想法？提 Issue 或邮件 [email protected]。

另请参阅

• Awesome Trading Agents —— 社区维护的 agent recipe 集合，把 data-mcp 工具串成端到端研究工作流（个股研究、宏观简报、smart money 追踪等）。
• 文档 —— 完整 API 参考、MCP 接入指南、credit policy。

贡献

本仓库是只读镜像，不接受 PR。

发现问题或有建议？直接 开 Issue。

License

MIT