Kronos

kronos-mcp

AI エージェント向けの株価予測 — 中国A株。

時系列のK線モデルである Kronos をラップした MCP サーバーです。銘柄を指定すると、次の N 日分のローソク足（始値／高値／安値／終値／出来高）を予測します。

対象は中国A株のみです。 2026-09-10 に確認済みです。AAPL、AAPL.US、 NASDAQ:AAPL、00700、0700.HK はすべて 404 を返します。上流にこれらの銘柄の K線データがありません。これはデータ上の制限であり、銘柄コードの形式の問題ではありません。

---

ツール

ツール	機能
kronos_health()	サービスに接続でき、キーが有効か確認します。問題が発生した場合は、まずこれを呼び出してください。
kronos_predict(symbol, pred_len)	次の pred_len 日分のローソク足を予測します（1～30、デフォルトは 10）。

kronos_predict は expected_return も返します。これは、最後に予測した終値を直近の実際の終値で割り、1 を引いた値です。多くの人が実際に知りたいのは、この比率です。

---

クイックスタート

最初に 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 で動作し、1 回の推論に 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_URL	https://kronos.agentpit.io	セルフホストする場合は、独自のデプロイ先を指定します
KRONOS_TIMEOUT	180	秒単位です。GPU 推論には 30～70 秒かかるため、短く設定しないでください
KRONOS_MCP_TRANSPORT	stdio	stdio | streamable-http | sse
KRONOS_MCP_HOST / KRONOS_MCP_PORT	0.0.0.0 / 8932	リモートトランスポートのみ

Claude Desktop、Cursor、uvx では stdio を使用します。複数のクライアントに対応する長時間稼働のサーバーが必要な場合に限り、リモートトランスポートを実行してください。また、MCP 仕様では SSE は非推奨とされているため、新しいセットアップでは streamable-http を推奨します。

---

予想される動作

各呼び出しには 30～70 秒かかります。 GPU による処理時間であり、ハングしているわけではありません。時間がかかるからといって再試行したり、何十もの銘柄に対してループ処理したりしないでください。上流ではリクエストごとに 1 銘柄を処理します。

これは統計的な外挿であり、投資助言ではありません。 モデルが参照するのは価格履歴のみです。ニュース、売買停止、決算日は考慮されません。通常とは異なる状況では、大きく外れることがあります。結果は多くの判断材料のうちの 1 つとして扱ってください。

---

発生する可能性のあるエラー

エラー	意味
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。