TickerDB MCP 服务器

Name: TickerAPI
Author: tickerdb

TickerDB 的 MCP (模型上下文协议) 服务器 — 为 AI 智能体提供预计算的市场情报。

将 TickerDB 连接到任何兼容 MCP 的客户端：Claude Desktop、Claude Code、Cursor、Windsurf、OpenClaw、LangChain、LlamaIndex、AutoGen、CrewAI 等。

可用工具

工具	描述
`get_summary`	单个代码的财务技术面 + 基本面摘要（支持日期范围和事件筛选）
`get_watchlist`	您已保存的自选股列表的实时数据
`get_watchlist_changes`	自上次流水线运行以来的字段级差异
`add_to_watchlist`	将代码添加到您的自选股列表
`remove_from_watchlist`	从您的自选股列表中移除代码
`get_account`	账户详情、套餐等级和使用情况
`create_webhook`	为自选股变动注册 Webhook
`list_webhooks`	列出已注册的 Webhook
`delete_webhook`	移除 Webhook

使用带有 start/end 参数的 get_summary 进行跨日期范围的批量代码同步，或使用 field/band 参数查询事件发生情况。

波段稳定性元数据

摘要、自选股和自选股变动工具会返回波段稳定性元数据。每个波段字段（趋势方向、动量区域等）都包含一个同级的 _meta 对象，用于描述该状态的稳定性。稳定性标签包括 fresh（新鲜）、holding（保持）、established（已确立）或 volatile（波动）。完整的元数据还包括 periods_in_current_state（当前状态持续周期）、flips_recent（近期翻转）和 flips_lookback（回溯翻转）。此上下文有助于智能体区分新进入的状态和已持续多个周期的状态，从而提高交易信号和警报的质量。

设置

选项 1：Claude.ai (OAuth)

位于 mcp.tickerdb.com 的远程服务器支持 Claude.ai 连接器的 OAuth 2.1。无需管理 API 密钥 — 使用您的 TickerDB 账户登录，Claude.ai 将处理其余事宜。

选项 2：远程服务器 (Bearer 令牌)

将任何 MCP 客户端连接到 https://mcp.tickerdb.com/mcp，并将您的 API 密钥作为 Bearer 令牌使用。

选项 3：npm 包 (Claude Desktop, Cursor 等)

添加到您的 Claude Desktop 配置 (claude_desktop_config.json) 中：

{
  "mcpServers": {
    "tickerdb": {
      "command": "npx",
      "args": ["tickerdb-mcp-server"],
      "env": {
        "TICKERDB_KEY": "tapi_your_api_key_here"
      }
    }
  }
}

在 tickerdb.com/dashboard 获取 API 密钥。

结构

这是一个包含三个包的工作区：

shared/ — 共享工具定义、API 客户端和服务器工厂（内部，未发布）
remote/ — 部署在 mcp.tickerdb.com 的 Cloudflare Worker（可流式传输的 HTTP 传输 + OAuth 2.1）
local/ — 已发布的 npm 包 tickerdb-mcp-server (stdio 传输)

远程服务器和 npm 包都使用来自 shared/ 的相同工具定义。MCP 服务器是一个轻量级代理 — 所有基于等级的访问控制、速率限制和字段过滤均由 TickerDB HTTP API 处理。

身份验证

远程服务器支持两种身份验证方法：

Bearer 令牌 — 直接将您的 tapi_* API 密钥作为 Authorization: Bearer tapi_... 传递
OAuth 2.1 — 由 Claude.ai 连接器使用。服务器实现了动态客户端注册、PKCE、令牌交换和撤销。/authorize 端点会重定向到 TickerDB 主站以获取授权。

开发

# Install dependencies
npm install

# Build the remote worker
npm run build

# Dev server for remote worker
npx wrangler dev

# Build the npm package
cd local && npm install && npm run build

部署

远程服务器：

npx wrangler deploy

npm 包：

cd local
npm version patch
npm run build
npm publish

TickerAPI