Kronos

io.github.hangeaiagent由 GitHub 帳號 hangeaiagent 發布v0.1.2更新於 Oct 24, 2026

Stock price forecasting for China A-shares — Kronos K-line time-series model

已驗證STDIO僅桌面金融AI 與機器學習

概覽

AI 產生的概覽

Kronos 封裝 K 線時間序列模型，讓助理預測中國 A 股標的未來數根日線。

可以做什麼
用健康檢查工具確認服務可連線、API 金鑰有效，發生錯誤時建議先呼叫。依股票代號預測未來 1 至 30 根日線（開盤、最高、最低、收盤、成交量），預設 10 根。回傳預期報酬率，即最後一根預測收盤價相對最後一根真實收盤價的變化。
適用情境
適合需要依近期價格歷史對中國 A 股代號做統計外推、並作為眾多參考之一時使用。不適合美股或港股代號，這些會回傳找不到的錯誤。
執行需求
以 Python 套件形式透過 uvx 或 pip 在本機執行，需要向服務商開發者入口申請 KRONOS 類型的 KRONOS_API_KEY（工作日通常數小時內核准，免費，預設每把金鑰 1000 次呼叫額度）。可選 KRONOS_URL、KRONOS_TIMEOUT 及傳輸方式設定。需要連線至上游服務的網路。
安裝前請注意
必須提供 API 金鑰，金鑰只顯示一次，且沒有免金鑰模式。每次呼叫需 30 至 70 秒 GPU 推論，不要因為感覺慢就重試，也不要對大量代號迴圈呼叫。輸出僅根據價格歷史做統計外推，不構成投資建議，在異常行情下可能嚴重偏離。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Kronos，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

kronos-mcp

Stock price forecasting for your AI agent — China A-shares.

An MCP server wrapping Kronos, a K-line time-series model. Ask it for a symbol, get the next N daily candles predicted: open / high / low / close / volume.

Coverage is China A-shares only. Verified 2026-09-10: AAPL, AAPL.US, NASDAQ:AAPL, 00700 and 0700.HK all return 404 — the upstream has no K-line data for them. This is a data limitation, not a symbol-format issue.

[License]

Tools

ToolWhat it does
kronos_health()Check the service is reachable and your key works. Call this first when something fails.
kronos_predict(symbol, pred_len)Predict the next pred_len daily candles (1–30, default 10)

kronos_predict also returns expected_return — last predicted close over last real close, minus one. That ratio is the number most people actually want.

Quick start

You need an API key first — see below.

Claude Desktop / Cursor

Add to claude_desktop_config.json:

json
{  "mcpServers": {    "kronos": {      "command": "uvx",      "args": ["kronos-mcp"],      "env": { "KRONOS_API_KEY": "oapk_xxx" }    }  }}

Command line

bash
# no install neededKRONOS_API_KEY=oapk_xxx uvx kronos-mcp
# or install itpip install kronos-mcpKRONOS_API_KEY=oapk_xxx kronos-mcp

API key

This server has no keyless mode, and cannot have one — the upstream returns 401 without a key.

The reason is cost, not gatekeeping: Kronos runs on our own GPUs and a single inference takes 30–70 seconds. Open anonymous access would let a handful of loops saturate the service, with no way to tell who is doing it.

Get one:

  1. Open https://hunter.agentpit.io/dev/api-keys and sign in
  2. Click 申请 API Key and choose API type KRONOS
  3. Copy the oapk_… key — it is shown once
  4. Set it as KRONOS_API_KEY

Approval usually lands within hours on a business day. Free, with a default quota of 1000 calls per key.

If the key is missing, this server does not return sample data or a fake success. It returns an error that tells you exactly where to get a key.

Environment variables

VariableDefaultNotes
KRONOS_API_KEY—Required. oapk_ key of type KRONOS
KRONOS_URLhttps://kronos.agentpit.ioPoint this at your own deployment if you self-host
KRONOS_TIMEOUT180Seconds. GPU inference is 30–70s — don't set this tight
KRONOS_MCP_TRANSPORTstdiostdio | streamable-http | sse
KRONOS_MCP_HOST / KRONOS_MCP_PORT0.0.0.0 / 8932Remote transports only

stdio is what Claude Desktop, Cursor and uvx use. Run a remote transport only if you want one long-running server serving several clients — and note the MCP spec marks SSE as deprecated, so prefer streamable-http for new setups.

What to expect

Every call takes 30–70 seconds. That is the GPU, not a hang. Don't retry because it feels slow, and don't loop it over dozens of symbols — upstream takes one symbol per request.

This is a statistical extrapolation, not investment advice. The model reads price history and nothing else: no news, no halts, no earnings dates. It will drift badly in unusual conditions. Treat the output as one input among many.

Errors you might hit

ErrorMeaning
missing_api_keyKRONOS_API_KEY not set — see API key
invalid_api_key (401)Key wrong, incomplete or revoked. Revocation takes up to 5 min to propagate
wrong_key_type (403)Key is valid but isn't a KRONOS key — you may have applied for KPRED or FIN_R1
symbol_not_found (404)Use 600519 or 600519.SH. A-shares only — US and HK tickers land here
rate_limited (429)Per-IP cap on invalid keys, or your quota is exhausted
upstream_down (502/504)GPU service restarting. If it lasts more than a few minutes, please open an issue

Related

  • truesource-mcp — verifiable first-hand market signals: filings, procurement wins, macro data
  • akshare-mcp — lets a model explore AKShare's 1000+ China market data functions on its own
  • hunter-community — the open-source stack these come from

Apache-2.0.

來源：tools/kronos-mcp/README.md，提交 4af6d96

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分