让 AI Agent 直接对话金融数据
stdb 提供标准 MCP 服务 —— 你的 Claude / OpenClaw / 其他 AI Agent 通过 MCP 协议一条配置即可连上， 原生调用 126 个行情接口 + 个人持仓记账，无需安装脚本、无需写代码。
🔗 MCP 端点
https://stdb.rewish.top/mcp
Streamable HTTP · 标准协议
🧰 13 个工具
数据查询 / 接口目录 / 自助申请 Key / 持仓记账 / T 收益分析
🔐 鉴权隔离
复用 API-Key：数据扣配额、持仓按 Key 隔离互不可见
🚀 快速开始（3 步）
选一种方式（HTTP 远程 / stdio 本机），见下方「Agent 配置」。
让 Agent 调用 apply_key 工具（或 curl -X POST https://stdb.rewish.top/mcp 见验证步骤）。
Key 只显示一次，请立即保存到密码管理器；遗失需联系管理员重置。
“查一下 600111 最近 3 天的日线” —— Agent 自动调 query 返回结构化数据。
🤖 Agent 配置
🌐 HTTP（远程，推荐）
任意机器可用，Agent 连到 stdb.rewish.top 即可。
{
"mcpServers": {
"stdb": {
"type": "http",
"url": "https://stdb.rewish.top/mcp"
}
}
}
Key 不预配 —— Agent 首次自动调 apply_key 申请并记忆。
💻 stdio（本机，脚本级）
在部署了 stdb 的机器上本地直连。
{
"mcpServers": {
"stdb": {
"command": "/home/ubuntu/stdb/.venv/bin/python",
"args": ["-m", "app.mcp_server"],
"env": {"PYTHONPATH": "/home/ubuntu/stdb"}
}
}
}🔧 工具清单（13 个）
| 工具 | 用途 | 关键参数 | 需 Key |
|---|---|---|---|
apply_key | 自助申请 API-Key（一个 IP/标识一个，只显示一次） | — | ❌ |
search | 按关键词搜索接口目录（126 个） | query | ❌ |
show | 查看接口参数与返回字段 | interface | ❌ |
query | 核心数据查询（行情/财务/龙虎榜等） | api_name, fields, params, api_key | ✅ |
usage | 查 Key 当日用量与额度 | api_key | ✅ |
holdings_list | 查看我的持仓（保本均价/浮盈亏） | api_key | ✅ |
holdings_buy / sell | 记录买入/卖出（加权成本，5 元手续费） | symbol, price, qty, api_key | ✅ |
holdings_adjust | 配置成本（设数量+均价，历史清零） | symbol, qty, avg_cost, api_key | ✅ |
holdings_flow | 股息(dividend)/补税(tax) | symbol, kind, amount, api_key | ✅ |
holdings_reset | 彻底清空该标的持仓与历史盈亏（谨慎） | symbol, api_key | ✅ |
t_ledger | 查看做 T 交易流水 | symbol, api_key | ✅ |
t_analyze | T 收益分析（配对/胜率/降本矩阵）；游客纯计算免 Key | symbol / cost_price+current_price, api_key | 游客可选 |
✅ 验证步骤（不连 Agent，用 curl 自测）
逐条复制到终端执行，对照「预期结果」确认服务可用（无需先申请 Key）。
① 握手（initialize）
curl -X POST https://stdb.rewish.top/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0"}}}'
✅ 预期：返回 event: message，含 capabilities 与 tools 能力声明 —— 说明 MCP 服务在线。
② 申请 Key（apply_key）
curl -X POST https://stdb.rewish.top/mcp/initialize # 上面握手拿到 session 后，按 MCP 规范发 tools/call；或让 Agent 直接调用 apply_key 工具
✅ 预期：返回 sk-xxxxxxxx（只显示一次），并提示「申请成功！请立即保存」。同 IP 二次调用返回同一个 Key（reused: true）。
③ 查询行情（query）
# 让 Agent 执行: query(api_name="stock/daily", fields="tradedate,symbol,close",
# params={symbols:"600111",startdate:"20260923",enddate:"20260924"}, api_key="sk-你的key")
✅ 预期：返回 ok: true + fields: [tradedate, symbol, close] + items（如 ["20260924","600111",37.06]）。
④ 持仓验证（holdings_list）
# 让 Agent 执行: holdings_list(api_key="sk-你的key")
✅ 预期：返回 ok: true + 你的持仓列表（空则 holdings: []）。持仓与 Key 绑定，别人看不到。
🛡️ 安全与限制
🔑 Key 只显示一次
申请响应里的 sk- 是唯一展示机会，务必立即保存。遗失无法找回，联系管理员重置。
🌍 一个 IP 一个 Key
同 IP 重复申请返回同一 Key（可当作找回入口）；不同 IP 各自独立。
📊 配额
默认 200 次/天（命中缓存也计 1 次）、每分钟 ≤30 次。用量可查 usage 工具或 /usage 页面。
🔒 隔离
持仓/交易流水按 Key 隔离；数据接口统一鉴权。对外不暴露任何后端架构细节。
❓ 常见问题
先调 apply_key 申请；检查是否把 Key 完整传给了 api_key 参数（只显示一次，可能被截断/复制不全）。
当日 200 次配额耗尽，等次日恢复，或联系管理员提升；省配额技巧：一次全量请求覆盖整段日期，别按日多次拉。
先 search("日线") 找接口，再 show("stock/daily") 看参数和字段，最后 query。
同 IP 再调 apply_key 会返回原 Key；换 IP 无法找回，联系管理员重置。
MCP 服务与 REST API、Skill 脚本三通道并存 —— 任选适合你 Agent 的接入方式。
数据仅供研究参考，不构成投资建议。