jiaoling-433-mcp 0.1.12

郊零 433 理财型 MCP 服务，可按 config.enable 切换实时行情模式与通用理财建议模式

郊零 433 MCP

基于你已经部署好的行情 API：

• http://119.29.160.124:9292/api/instruments/
• http://119.29.160.124:9292/api/historical-data/

对外提供一个可通过 uvx 启动的 MCP 数据服务，面向“433 中庸策略”场景，提供：

• config.json 的 enable 开关控制的两种模式
• enable=true 时返回候选产品池与实时行情数据，并把 tips.md 作为 prompt 返回给大模型
• enable=false 时不返回具体证券策略数据，只返回通用理财建议 prompt

enable 支持两种设置方式：

• 根目录 config.json 的 enable
• 环境变量 JIAOLING_ENABLE

优先级：JIAOLING_ENABLE 高于 config.json

1. 本地运行

cd MCP
uvx --from . jiaoling-433-mcp

如果需要改 API 地址：

JIAOLING_API_BASE_URL=http://127.0.0.1:8000 uvx --from . jiaoling-433-mcp

2. Codex / MCP 配置

当前目录已提供：

• .mcp.json
• .codex-plugin/plugin.json

默认会连接：

http://119.29.160.124:9292

3. 主要工具

• list_curated_products_data
• get_data

get_data 的核心规则：

• 始终返回 enable、mode、prompt
• enable=true 时：
  • amout 必传
  • 目标价格：amout / 1000
  • 先通过行情 API 的 price_max 参数筛出价格 <= 目标价格 的 ETF、LOF、股票、基金
  • API 端按 last_price 从高到低排序，MCP 默认只拿前 20 个候选
  • MCP 再从这批候选里选出前 10 个备选
  • 只有价差在 3% 内时，才优先能源方向，特别是石油/原油
  • 只有价差在 1% 内时，才优先 ETF > LOF > 股票 > 基金
  • 再用实时价格二次过滤，只保留当前仍 <= 目标价格 的产品
  • 返回 top3 真实行情数据，供大模型结合 tips.md 输出建议
• enable=false 时：
  • 不请求具体行情
  • 不返回具体证券策略数据
  • 仅返回用于通用理财建议的 prompt

4. 当前边界

• 当前数据底座主要覆盖：股票、ETF、LOF、开放式基金
• 用户文案里提到的指数、港股如 00883，如果底层 API 没有对应数据，会自动跳过并说明原因
• 实时行情接口在线上环境偶发超时，因此 Top3 会先根据昨天数据建候选池，再用实时价格二次校验
• 当 config.json 中 enable=false 时，MCP 不应输出任何具体证券代码或可执行买卖策略