astock-mcp-cn 0.2.0__tar.gz

astock_mcp_cn-0.2.0/.gitignore

@@ -0,0 +1,7 @@
+.venv/
+dist/
+build/
+__pycache__/
+*.py[cod]
+*.egg-info/
+.uv/

astock_mcp_cn-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 astock-mcp contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

astock_mcp_cn-0.2.0/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.5
+Name: astock-mcp-cn
+Version: 0.2.0
+Summary: A-share market data MCP server: realtime quotes, klines, market breadth, sector fund flow, screener. Pure HTTP, no akshare/pandas.
+License: MIT
+License-File: LICENSE
+Keywords: a-share,china,market-data,mcp,model-context-protocol,stock
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.2.0
+Requires-Dist: requests>=2.28
+Description-Content-Type: text/markdown
+
+# astock-mcp-cn
+
+A 股行情 MCP 服务。5 个工具、纯 HTTP 取数，不依赖 akshare / pandas，冷启动 1 秒内，适合本地或云端托管。
+
+## 工具
+
+**行情**
+
+| 工具 | 用途 |
+|---|---|
+| `quote(symbols)` | 实时报价，多只逗号分隔，代码或名称均可；含涨跌幅、换手率、量比、PE、PB、总市值 |
+| `kline(symbol, period, limit, adjust)` | 日/周/月 K 线，含每日涨跌幅与换手率，末尾附 MA5 / MA20 / 区间涨跌 |
+| `market_overview()` | 六大指数点位涨跌 + 全市场涨跌家数 + 涨停跌停家数 |
+| `intraday(symbol)` | 当日分时要点：开高低现、均价、振幅、量能分布、尾盘 30 分钟、站上均价比例 |
+
+**情绪与资金**
+
+| 工具 | 用途 |
+|---|---|
+| `limit_up(limit)` | 涨停梯队：家数、最高连板、**封单额占流通市值比**、首封时间、炸板次数、所属行业、10天N板 |
+| `money_flow(symbol, days)` | 个股近 N 日主力 / 超大单 / 大单 / 小单净额与主力净占比 |
+| `sector_flow(limit, direction)` | 行业板块主力资金净流入/流出排行 |
+| `dragon_tiger(limit)` | 最近交易日龙虎榜：净买入额、买卖额、上榜原因 |
+
+**筛股与基本面**
+
+| 工具 | 用途 |
+|---|---|
+| `screen(...)` | 条件选股：涨跌幅、换手率、PE、总市值 |
+| `fundamental(symbol)` | 财务快照：加权 ROE、毛利率、资产负债率、营收及同比、EPS、BPS |
+| `announcements(symbol)` | 近期公告标题（不含正文） |
+
+### 判断"明天能不能上板"用哪些
+
+`limit_up` 看封板质量（首封越早、封单占流通比越高、炸板越少越强）→ `money_flow` 看主力是否真进场 → `dragon_tiger` 看是游资还是机构 → `intraday` 看是否全天站上均价 → `announcements` 看消息催化 → `market_overview` 看情绪周期。
+
+## 安装
+
+```bash
+pip install astock-mcp-cn
+# 或
+uvx astock-mcp-cn
+```
+
+## 接入 MCP 客户端
+
+stdio 传输，命令即 `astock-mcp`：
+
+```json
+{
+  "mcpServers": {
+    "astock": { "command": "uvx", "args": ["astock-mcp-cn"] }
+  }
+}
+```
+
+## 数据源
+
+| 数据 | 主源 | 备源 |
+|---|---|---|
+| 实时报价 | 腾讯 `qt.gtimg.cn` | 新浪 `hq.sinajs.cn` |
+| K 线 | 东方财富 `push2his` | 腾讯 `web.ifzq.gtimg.cn` |
+| 资金流 / 选股 / 涨跌家数 | 东方财富 `push2` | — |
+
+数据来自公开行情接口，可能存在延迟或口径差异，仅供信息参考。
+
+## 说明
+
+- `screen` 从东财榜单前 300 只里筛选（接口单页上限 100 条，按 `sort` 字段排序后取头部），不是全市场扫描；适合快速看方向，不适合严谨回测。
+- 输出做了紧凑处理以节省上下文 token，默认条数克制。
+- 结果在进程内缓存 20–180 秒，避免重复请求。
+
+## 免责声明
+
+本项目仅提供公开行情数据的读取能力，不构成任何投资建议。投资有风险，决策需谨慎。
+
+## License
+
+MIT

astock_mcp_cn-0.2.0/README.md

@@ -0,0 +1,79 @@
+# astock-mcp-cn
+
+A 股行情 MCP 服务。5 个工具、纯 HTTP 取数，不依赖 akshare / pandas，冷启动 1 秒内，适合本地或云端托管。
+
+## 工具
+
+**行情**
+
+| 工具 | 用途 |
+|---|---|
+| `quote(symbols)` | 实时报价，多只逗号分隔，代码或名称均可；含涨跌幅、换手率、量比、PE、PB、总市值 |
+| `kline(symbol, period, limit, adjust)` | 日/周/月 K 线，含每日涨跌幅与换手率，末尾附 MA5 / MA20 / 区间涨跌 |
+| `market_overview()` | 六大指数点位涨跌 + 全市场涨跌家数 + 涨停跌停家数 |
+| `intraday(symbol)` | 当日分时要点：开高低现、均价、振幅、量能分布、尾盘 30 分钟、站上均价比例 |
+
+**情绪与资金**
+
+| 工具 | 用途 |
+|---|---|
+| `limit_up(limit)` | 涨停梯队：家数、最高连板、**封单额占流通市值比**、首封时间、炸板次数、所属行业、10天N板 |
+| `money_flow(symbol, days)` | 个股近 N 日主力 / 超大单 / 大单 / 小单净额与主力净占比 |
+| `sector_flow(limit, direction)` | 行业板块主力资金净流入/流出排行 |
+| `dragon_tiger(limit)` | 最近交易日龙虎榜：净买入额、买卖额、上榜原因 |
+
+**筛股与基本面**
+
+| 工具 | 用途 |
+|---|---|
+| `screen(...)` | 条件选股：涨跌幅、换手率、PE、总市值 |
+| `fundamental(symbol)` | 财务快照：加权 ROE、毛利率、资产负债率、营收及同比、EPS、BPS |
+| `announcements(symbol)` | 近期公告标题（不含正文） |
+
+### 判断"明天能不能上板"用哪些
+
+`limit_up` 看封板质量（首封越早、封单占流通比越高、炸板越少越强）→ `money_flow` 看主力是否真进场 → `dragon_tiger` 看是游资还是机构 → `intraday` 看是否全天站上均价 → `announcements` 看消息催化 → `market_overview` 看情绪周期。
+
+## 安装
+
+```bash
+pip install astock-mcp-cn
+# 或
+uvx astock-mcp-cn
+```
+
+## 接入 MCP 客户端
+
+stdio 传输，命令即 `astock-mcp`：
+
+```json
+{
+  "mcpServers": {
+    "astock": { "command": "uvx", "args": ["astock-mcp-cn"] }
+  }
+}
+```
+
+## 数据源
+
+| 数据 | 主源 | 备源 |
+|---|---|---|
+| 实时报价 | 腾讯 `qt.gtimg.cn` | 新浪 `hq.sinajs.cn` |
+| K 线 | 东方财富 `push2his` | 腾讯 `web.ifzq.gtimg.cn` |
+| 资金流 / 选股 / 涨跌家数 | 东方财富 `push2` | — |
+
+数据来自公开行情接口，可能存在延迟或口径差异，仅供信息参考。
+
+## 说明
+
+- `screen` 从东财榜单前 300 只里筛选（接口单页上限 100 条，按 `sort` 字段排序后取头部），不是全市场扫描；适合快速看方向，不适合严谨回测。
+- 输出做了紧凑处理以节省上下文 token，默认条数克制。
+- 结果在进程内缓存 20–180 秒，避免重复请求。
+
+## 免责声明
+
+本项目仅提供公开行情数据的读取能力，不构成任何投资建议。投资有风险，决策需谨慎。
+
+## License
+
+MIT

astock_mcp_cn-0.2.0/apply_config.py

@@ -0,0 +1,39 @@
+"""只改麦麦 bot_config.toml 的 [mcp].servers 一行；二进制读写，保留原换行符。"""
+
+import shutil
+import time
+import tomllib
+from pathlib import Path
+
+P = Path(r"C:\Users\GUDGA\AppData\Roaming\MaiBotOneKeyDesktop\4d542e1f4fde\modules\MaiBot\config\bot_config.toml")
+EXE = "C:/Users/GUDGA/WorkBuddy/2026-11-06-02-03-59/astock-mcp/.venv/Scripts/astock-mcp.exe"
+
+raw = P.read_bytes()
+old = b"servers = []"
+assert raw.count(old) == 1, f"目标行数量异常: {raw.count(old)}"
+nl = b"\r\n" if b"\r\n" in raw else b"\n"
+
+block = nl.join(
+    [
+        b"servers = [",
+        b'    { name = "astock", enabled = true, transport = "stdio", command = "'
+        + EXE.encode("utf-8")
+        + b'", args = [], http_timeout_seconds = 15.0, read_timeout_seconds = 30.0 },',
+        b"]",
+    ]
+)
+
+bak = P.with_name(P.name + ".bak-manual-" + time.strftime("%Y%m%d-%H%M%S"))
+shutil.copy2(P, bak)
+
+new_raw = raw.replace(old, block)
+P.write_bytes(new_raw)
+
+data = tomllib.loads(new_raw.decode("utf-8"))
+print("backup :", bak.name)
+print("bytes  :", len(raw), "->", len(new_raw))
+print("CRLF   :", new_raw.count(b"\r\n"), "| bare LF:", new_raw.count(b"\n") - new_raw.count(b"\r\n"))
+print("mcp.enable :", data["mcp"]["enable"])
+for srv in data["mcp"]["servers"]:
+    print("server :", {k: srv.get(k) for k in ("name", "enabled", "transport", "command")})
+print("personality keys:", len(data.get("personality", {})))

astock_mcp_cn-0.2.0/probe_sources.py

@@ -0,0 +1,87 @@
+"""探测候选数据源可用性：涨停梯队 / 个股资金流 / 分时 / 龙虎榜 / 财务 / 公告 / 北向。"""
+
+import json
+
+import requests
+
+S = requests.Session()
+S.headers.update(
+    {
+        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 Chrome/124.0 Safari/537.36",
+        "Referer": "https://quote.eastmoney.com/",
+    }
+)
+
+
+def probe(name, url, pick):
+    try:
+        resp = S.get(url, timeout=10)
+        payload = resp.json()
+        print(f"[OK] {name}  http={resp.status_code}  {pick(payload)}")
+    except Exception as exc:  # noqa: BLE001
+        print(f"[--] {name}  {type(exc).__name__}: {str(exc)[:90]}")
+
+
+# 1 涨停池（连板/封板资金）
+probe(
+    "涨停池(含连板)",
+    "https://push2ex.eastmoney.com/getTopicZTPool?ut=7eea3edcaed734bea9cbfc24409ed989"
+    "&dpt=wz.ztzt&Pageindex=0&pagesize=10&sort=fbt%3Aasc&date=20261106",
+    lambda p: f"pool={len((p.get('data') or {}).get('pool') or [])} keys={list(((p.get('data') or {}).get('pool') or [{}])[0].keys())[:12]}",
+)
+
+# 2 个股当日资金流
+probe(
+    "个股资金流(今日)",
+    "https://push2.eastmoney.com/api/qt/stock/get?secid=1.600900"
+    "&fields=f43,f57,f58,f62,f184,f66,f72,f78,f84",
+    lambda p: json.dumps(p.get("data"), ensure_ascii=False)[:160],
+)
+
+# 3 个股资金流（多日）
+probe(
+    "个股资金流(近6日)",
+    "https://push2his.eastmoney.com/api/qt/stock/fflow/daykline/get?secid=1.600900&lmt=6&klt=101"
+    "&fields1=f1,f2,f3,f7&fields2=f51,f52,f53,f54,f55,f56,f57,f58,f59,f60,f61,f62,f63,f64,f65",
+    lambda p: f"klines={(p.get('data') or {}).get('klines', [])[:2]}",
+)
+
+# 4 分时
+probe(
+    "分时走势",
+    "https://push2his.eastmoney.com/api/qt/stock/trends2/get?secid=1.600900"
+    "&fields1=f1,f2,f3,f4,f5,f6,f7,f8&fields2=f51,f52,f53,f54,f55,f56,f57,f58&iscr=0&ndays=1",
+    lambda p: f"points={len(((p.get('data') or {}).get('trends')) or [])} sample={(((p.get('data') or {}).get('trends')) or [''])[0]}",
+)
+
+# 5 龙虎榜
+probe(
+    "龙虎榜",
+    "https://datacenter-web.eastmoney.com/api/data/v1/get?reportName=RPT_DAILYBILLBOARD_DETAILSNEW"
+    "&columns=ALL&filter=(TRADE_DATE%3D%272026-11-06%27)&pageNumber=1&pageSize=5&sortColumns=NET_BUY_AMT&sortTypes=-1",
+    lambda p: f"count={((p.get('result') or {}).get('data') or []) and len((p.get('result') or {}).get('data'))} keys={list((((p.get('result') or {}).get('data') or [{}])[0]).keys())[:10]}",
+)
+
+# 6 财务主要指标
+probe(
+    "财务指标",
+    "https://datacenter-web.eastmoney.com/api/data/v1/get?reportName=RPT_F10_FINANCE_MAINFINADATA"
+    "&columns=SECUCODE,SECURITY_NAME_ABBR,REPORT_DATE,ROE_DILUTED,GROSS_PROFIT_RATIO,DEBT_ASSET_RATIO,TOTAL_OPERATE_INCOME,YSTZ,SJLTZ"
+    "&filter=(SECUCODE%3D%22600900.SH%22)&pageNumber=1&pageSize=2&sortColumns=REPORT_DATE&sortTypes=-1",
+    lambda p: json.dumps((((p.get("result") or {}).get("data")) or [{}])[0], ensure_ascii=False)[:180],
+)
+
+# 7 公告
+probe(
+    "公告",
+    "https://np-anotice-stock.eastmoney.com/api/security/ann?sr=-1&page_size=3&page_index=1"
+    "&ann_type=A&client_source=web&stock_list=600900&f_node=0&s_node=0",
+    lambda p: f"items={len((p.get('data') or {}).get('list') or [])} first={(((p.get('data') or {}).get('list')) or [{}])[0].get('title', '')[:40]}",
+)
+
+# 8 北向资金（2024-08 起停止实时披露，验证是否还有数据）
+probe(
+    "北向资金",
+    "https://push2.eastmoney.com/api/qt/kamt/get?fields1=f1,f3&fields2=f51,f52,f54,f56",
+    lambda p: json.dumps(p.get("data"), ensure_ascii=False)[:200],
+)

astock_mcp_cn-0.2.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "astock-mcp-cn"
+version = "0.2.0"
+description = "A-share market data MCP server: realtime quotes, klines, market breadth, sector fund flow, screener. Pure HTTP, no akshare/pandas."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+keywords = ["mcp", "model-context-protocol", "a-share", "stock", "market-data", "china"]
+dependencies = [
+    "mcp>=1.2.0",
+    "requests>=2.28",
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+[project.scripts]
+astock-mcp = "astock_mcp.server:main"
+astock-mcp-cn = "astock_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/astock_mcp"]

astock_mcp_cn-0.2.0/src/astock_mcp/__init__.py

@@ -0,0 +1,13 @@
+"""astock-mcp —— A 股行情 MCP 服务（报价 / K线 / 大盘 / 板块资金 / 选股）。"""
+
+__version__ = "0.2.0"
+__all__ = ["mcp", "__version__"]
+
+
+def __getattr__(name: str):
+    """惰性导出，避免 `python -m astock_mcp.server` 时重复导入模块。"""
+    if name == "mcp":
+        from .server import mcp
+
+        return mcp
+    raise AttributeError(name)