mcpField
K
Kronos

Kronos

本地服务
github.com/agentpit-io金融数据5762 周前更新
代码仓库

关于 Kronos

Kronos 是面向中国 A 股的 MCP 服务，封装了 K 线时间序列模型 Kronos，可预测标的未来 N 个交易日的开盘价、最高价、最低价、收盘价和成交量。适合需要量化价格走势参考的 AI Agent 用户。服务仅覆盖 A 股，并返回预期收益率等派生指标。

主要功能

  1. 01预测未来 1 至 30 个日 K 线
  2. 02返回开高低收与成交量
  3. 03计算预测收益率 expected_return
  4. 04提供 kronos_health 连接与密钥检查

适用场景

  1. 01为 AI Agent 提供 A 股短期价格走势的统计外推
  2. 02批量评估 A 股标的的预测收益率（注意单次调用耗时较长）
  3. 03排查 API 密钥或服务连接问题

MCP 相关

该项目是 MCP 服务，向 MCP 客户端暴露 kronos_health 和 kronos_predict 两个工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "hangeaiagent-kronos": {
      "command": "uvx",
      "args": [
        "kronos-mcp"
      ],
      "env": {
        "KRONOS_API_KEY": "<KRONOS_API_KEY>",
        "KRONOS_URL": "<KRONOS_URL>",
        "KRONOS_TIMEOUT": "<KRONOS_TIMEOUT>"
      }
    }
  }
}
启动命令uvx kronos-mcp
需要配置的环境变量
KRONOS_API_KEY密钥KRONOS-type API key from https://hunter.agentpit.io/dev/api-keys
KRONOS_URLOverride the upstream endpoint if you self-host
KRONOS_TIMEOUTRead timeout in seconds. GPU inference takes 30-70s

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypikronos-mcp0.1.2

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

kronos-mcp

为你的 AI Agent 预测股票价格——中国 A 股。

一个封装了 Kronos（K 线时间序列模型）的 MCP 服务。输入股票代码，即可获取未来 N 根日 K 线的预测值：开盘价／最高价／最低价／收盘价／成交量。

仅覆盖中国 A 股。 经验证，日期为 2026-09-10：AAPL、AAPL.US、 NASDAQ:AAPL、00700 和 0700.HK 均返回 404——上游没有这些股票的 K 线数据。这是数据限制，并非股票代码格式问题。

许可证

工具

工具功能
kronos_health()检查服务是否可访问，以及你的密钥是否有效。遇到故障时，请先调用此工具。
kronos_predict(symbol, pred_len)预测未来 pred_len 根日 K 线（1–30，默认 10 根）

kronos_predict 还会返回 expected_return——最后一个预测收盘价除以最近一个实际收盘价，再减去一。这个比率才是大多数人真正想要的数字。

快速开始

你需要先获取 API 密钥——请参阅下文。

Claude Desktop / Cursor

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "kronos": {
      "command": "uvx",
      "args": ["kronos-mcp"],
      "env": { "KRONOS_API_KEY": "oapk_xxx" }
    }
  }
}
命令行
# no install needed
KRONOS_API_KEY=oapk_xxx uvx kronos-mcp

# or install it
pip install kronos-mcp
KRONOS_API_KEY=oapk_xxx kronos-mcp

API 密钥

此服务没有无密钥模式，也无法提供这种模式——上游在没有密钥时会返回 401。

原因是成本，而不是限制访问：Kronos 运行在我们自己的 GPU 上，单次推理需要 30–70 秒。开放匿名访问后，少数几个循环调用就能让服务过载，而且我们无从判断是谁在调用。

获取密钥：

  1. 打开 https://hunter.agentpit.io/dev/api-keys 并登录
  2. 点击 申请 API Key，选择 API 类型 KRONOS
  3. 复制 oapk_… 密钥——它只会显示一次
  4. 将其设置为 KRONOS_API_KEY

工作日通常会在几小时内获批。免费，每个密钥的默认配额为 1000 次调用。

如果缺少密钥，此服务不会返回示例数据或伪造成功结果，而是会返回错误，并明确告知你在哪里获取密钥。

环境变量

变量默认值说明
KRONOS_API_KEY—必填。 类型为 KRONOS 的 oapk_ 密钥
KRONOS_URLhttps://kronos.agentpit.io如果自托管，可将其指向你自己的部署
KRONOS_TIMEOUT180秒。GPU 推理需要 30–70 秒——不要将其设得太短
KRONOS_MCP_TRANSPORTstdiostdio | streamable-http | sse
KRONOS_MCP_HOST / KRONOS_MCP_PORT0.0.0.0 / 8932仅用于远程传输

Claude Desktop、Cursor 和 uvx 使用的是 stdio。只有在需要一个长期运行的服务为多个客户端提供服务时，才运行远程传输——另请注意，MCP 规范已将 SSE 标记为弃用，因此新配置请优先使用 streamable-http。

使用须知

每次调用需要 30–70 秒。 这是 GPU 推理所需的时间，不是卡住了。不要因为感觉太慢就重试，也不要对几十个股票代码循环调用——上游每个请求只能处理一个股票代码。

这只是统计外推，并非投资建议。 模型只读取价格历史：没有新闻、停牌信息或财报日期。在异常情况下，预测会出现严重偏差。请将输出作为众多参考因素之一。

可能遇到的错误

错误含义
missing_api_key未设置 KRONOS_API_KEY——请参阅 API 密钥
invalid_api_key (401)密钥错误、不完整或已撤销。撤销操作最多需要 5 分钟生效
wrong_key_type (403)密钥有效，但不是 KRONOS 密钥——你可能申请了 KPRED 或 FIN_R1
symbol_not_found (404)请使用 600519 或 600519.SH。仅限 A 股——美股和港股代码会返回此错误
rate_limited (429)无效密钥的单 IP 调用上限已达，或你的配额已用尽
upstream_down (502/504)GPU 服务正在重启。如果持续几分钟以上，请提交 issue

相关项目

  • truesource-mcp — 可验证的一手市场信号：申报文件、采购中标信息、宏观数据
  • akshare-mcp — 让模型自行探索 AKShare 的 1000 多个中国市场数据函数
  • hunter-community — 这些项目所基于的开源技术栈

Apache-2.0。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。