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 分