Metadata-Version: 2.4
Name: jiaoling-433-mcp
Version: 0.1.1
Summary: 郊零 433 数据型 MCP 服务，基于现有行情 API 提供候选池、Top3 行情和单标的市场数据
Project-URL: Homepage, http://119.29.160.124:9292/
Project-URL: Documentation, http://119.29.160.124:9292/
Project-URL: Source, http://119.29.160.124:9292/
Author-email: JiaoLing Strategy Lab <support@example.com>
License: MIT
License-File: LICENSE
Keywords: etf,finance,market-data,mcp,stocks
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.11
Requires-Dist: fastmcp<3.0.0,>=2.10.6
Requires-Dist: httpx<1.0.0,>=0.27.0
Requires-Dist: pydantic<3.0.0,>=2.8.0
Description-Content-Type: text/markdown

# 郊零 433 MCP

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

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

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

- 候选产品池基础数据
- Top3 产品实时/最新行情数据
- 单标的市场快照
- 基于历史波动自动估算 `Z` 作为数据字段返回

## 1. 本地运行

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

如果需要改 API 地址：

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

## 2. Codex / MCP 配置

当前目录已提供：

- `.mcp.json`
- `.codex-plugin/plugin.json`

默认会连接：

```text
http://119.29.160.124:9292
```

## 3. 主要工具

- `list_curated_products_data`
- `get_top3_realtime_data`
- `get_product_market_data`

## 4. 当前策略边界

- 当前数据底座主要覆盖：股票、ETF、LOF、开放式基金
- 用户文案里提到的指数、港股如 `00883`，如果底层 API 没有对应数据，会自动跳过并说明原因
- 实时行情接口在线上环境偶发超时，因此 MCP 会优先尝试实时接口，失败时回退到最新历史收盘/净值
