TrueSource

truesource-mcp

AI エージェントが実際に出典を示せる、一次情報に基づく市場シグナル。

TrueSource をラップした MCP サーバーです。TrueSource は、すでに 発生した ことがあり、検証可能な出典を持つ情報（取引所への届け出、政府調達の落札、研究開発の拡大に関する動き、北向き資金の保有状況、公式なマクロ経済発表など）を監視するクローラーと AI 検索のスタックです。

アナリストレポートを要約したり、売買の推奨を出したりはしません。すべてのシグナルに日付と出典が付いています。

---

ツール

ツール	機能	速度
truesource_procurement(days, limit)	最近の政府調達の落札情報 — 実際に契約を獲得している企業	高速
truesource_macro(days)	統計局、税関、業界団体によるマクロ経済の発表	高速
truesource_daily_brief(symbols)	複数のティッカーを対象とするシグナルのダイジェストと警戒レベル（直近3日間）	高速
truesource_alert_signals(symbols)	警戒基準を超えたシグナルのみ（直近26時間）	高速
truesource_report(symbol)	詳細な調査レポート — 事前設定されたAIコンピューティング関連銘柄35銘柄のみ	高速
truesource_scout(symbol, name)	あらゆるA株を対象とした、リアルタイムの全件収集	30～60秒

最も特徴的なのは政府調達のツールです。契約の落札は、すでに発生した事実であり、予測よりも確かな情報です。

---

クイックスタート

まず API キーが必要です。下記をご覧ください。

Claude Desktop / Cursor

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "truesource": {
      "command": "uvx",
      "args": ["truesource-mcp"],
      "env": { "HUNTER_API_KEY": "hunt_tools_xxx" }
    }
  }
}

コマンドライン

# no install needed
HUNTER_API_KEY=hunt_tools_xxx uvx truesource-mcp

# or install it
pip install truesource-mcp
HUNTER_API_KEY=hunt_tools_xxx truesource-mcp

---

API キー

このサーバーにはキーなしで利用するモードはなく、今後も提供できません。上流のゲートウェイはキーがない場合、403 を返します。

理由はコストです。truesource_scout は呼び出しのたびに実際のクローラーを実行し、Gemini 検索も行うため、各呼び出しでサードパーティー API の利用料金が発生します。匿名アクセスは簡単に悪用されて高額な費用が発生し、利用者を特定することもできません。

https://hunter.agentpit.io/dev/api-keys で取得できます。サインインして 申请 API Key をクリックし、hunt_tools_… キー（表示は1回のみ）をコピーして、HUNTER_API_KEY に設定してください。

キーが設定されていない場合、このサーバーはサンプルデータを返したり、成功したように装ったりしません。キーの取得先を明示したエラーを返します。

---

環境変数

変数	デフォルト	備考
HUNTER_API_KEY	—	必須。 hunt_tools_ キー
TRUESOURCE_URL	https://hunter.agentpit.io/api/saas/truesource	セルフホストする場合は、独自のデプロイ先を指定します
TRUESOURCE_TIMEOUT	20	秒。scout には別途、最低120秒が設定されます
TRUESOURCE_MAX_ITEMS	40	1レスポンスあたりの項目数の上限
TRUESOURCE_MCP_TRANSPORT	stdio	stdio | streamable-http | sse
TRUESOURCE_MCP_HOST / _PORT	0.0.0.0 / 8933	リモートトランスポートのみ

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

そうしないと問題になる3つの点

grey は green ではありません。 daily_brief で、アラートレベルが grey ということは、過去3日間にこのティッカーのシグナルが収集されていないことを意味します。株価が落ち着いていた可能性もあれば、カバレッジから漏れていた可能性もあります。「安全」という意味ではありません。

空の結果は結論であり、失敗ではありません。 alert_signals が何も返さない場合、これらのティッカーは過去26時間にしきい値を超えていません。これは情報です。このサーバーは空の結果をエラーに見せかけたり、プレースホルダーの行で埋めたりすることはありません。

切り詰めは必ず明示されます。 レスポンスは TRUESOURCE_MAX_ITEMS（デフォルトは40）に制限されます。上限に達すると、ペイロードには truncated: true と実際の total が含まれ、表示された範囲だけから結論を出さないよう注記されます。上限を引き上げるか、日付範囲を絞ってください。

また、truesource_report は、ティッカーが35個の事前構築済み銘柄のいずれでもない場合に、scout へ暗黙にフォールバックすることはありません。Scout には30～60秒と実費がかかります。この選択は意図的に行うべきであり、ユーザーに知らせずに実行されるべきではありません。

---

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

エラー	意味
missing_api_key	HUNTER_API_KEY が設定されていません。API キーを参照してください
invalid_api_key (401)	キーが誤っている、不完全である、または失効しています
forbidden (403)	キーは有効ですが、このエンドポイントへのアクセス権がありません
not_found (404)	report の場合：ティッカーが事前構築済み銘柄ではありません。truesource_scout を使用してください
timeout	scout の実行には実際に30～60秒かかります。TRUESOURCE_TIMEOUT を引き上げてください
upstream_down (502/503)	クローラーサービスが停止しています。後でもう一度お試しください

---

関連項目

• kronos-mcp — A株、米国株、香港株のローソク足予測
• akshare-mcp — モデルがAKShareの1000以上の中国市場データ関数を自ら活用できます
• hunter-community — これらの基盤となっているオープンソースのスタック

Apache-2.0。