# 腾讯A股行情 MCP（Cloudflare Workers）

这是一个尽量简单的只读 MCP 服务，提供三个工具：

- `get_stock_quotes`：最新行情快照
- `get_daily_kline`：日K线
- `market_data_health`：连通性检查

## 最简单部署方法

1. 注册 GitHub 和 Cloudflare。
2. 在 GitHub 新建一个空仓库，例如 `tencent-stock-mcp`。
3. 把本文件夹里的所有文件上传到仓库根目录，保持 `src/server.ts` 的目录结构。
4. Cloudflare -> Workers & Pages -> Create application -> Import a repository。
5. 选择刚才的 GitHub 仓库。
6. Worker 名称保持 `tencent-stock-mcp`。
7. Deploy command 使用默认的 `npx wrangler deploy`。
8. 保存并部署。
9. 成功后你的 MCP 地址通常是：
   `https://tencent-stock-mcp.<你的workers子域>.workers.dev/mcp`
10. 在 ChatGPT 网页版 -> Settings -> Apps -> Advanced Settings 开启 Developer mode；
    再到 Apps -> Create，填入上面的 `/mcp` 地址，选择无身份验证，Scan tools。
11. 应看到 3 个工具：
    `get_stock_quotes`、`get_daily_kline`、`market_data_health`。

## 首次测试建议

在 ChatGPT 中选择这个 App，然后输入：

“请调用 market_data_health，告诉我腾讯行情源是否正常，并明确返回行情的 quote_time。”

再测试：

“请调用 get_stock_quotes 查询东方财富300059和中信建投601066。必须告诉我每只股票的 quote_time，不要把上一交易日数据说成今日实时数据。”

## 重要说明

- 腾讯这类行情端点并非有正式 SLA 的商业开发者 API。
- 盘前看到上一交易日时间戳是正常现象。
- 不要把接口失败后的网页搜索结果自动当成实时行情。
- 第一阶段建议只用于持仓/候选复核；全市场数千股票扫描需要再做批量、缓存和限流优化。