AuraStream

aurastream-mcp

AuraStream向けのMCPサーバーです。AuraStreamは、統合された過去データAPIです。Claude Desktop、Claude Code、ChatGPTなどのMCPクライアントから、暗号資産取引所、Yahoo Finance、Oanda、Alpaca、PolygonなどのOHLCVバー（ソースによっては、資金調達率、取引、気配値、板情報、決算情報も）を取得できます。さらに、FRED、CFTCのトレーダー建玉報告、SECのインサイダー取引、決算関連の届出、予定されているインサイダー売却、8-Kイベント、受け渡し未履行、13D/13Gの保有情報、13Fおよび投資信託／ETFの保有銘柄と議決権行使、米国の経済指標発表カレンダー、英国／EU／米国／香港の金属貿易、TSAの旅行者数、過去の天候と積算温度、米国の小売売上高と個人消費支出（PCE）、USDAの作物予測（WASDE）、EUの空売りポジション、WARNのレイオフ通知、連邦政府の契約支出、FRBの声明・議事録・講演などのマクロ、ポジショニング、資金フローのデータも取得できます。AuraStreamの全45ソースに、1つのツールからアクセスできます。

「Binanceの第1四半期のBTC日次終値をプロットして」「今年のSPYとQQQのドローダウンを比較して」「2020年以降、ヘッジファンドは金先物でどのようなポジションを取ってきた？」と尋ねると、モデルがAuraStreamを呼び出してデータを取得します。

ツール

ツール	機能
list_sources()	ソース、資産クラス、ティッカーの形式、インターバル、対応するデータ型、ソース固有のパラメーター、プロバイダーの認証情報が必要かどうか、設定済みかどうかを確認します。API 呼び出しは行いません。
get_timeseries(source, tickers, start, end, interval="1d", dtype="bars", price_type=None, instrument=None, continuous_contracts=None, ticktype=None, assetclass=None, category=None, feed=None, adjustment=None, indicator=None, dataset=None, report=None, options=None, as_of=None, concepts=None, period=None, mode=None, reporter=None, metric=None, level=None, db=None, filters=None, assetcol=None, index=None, variables=None, timezone=None, unit_group=None, vs_currency=None, sessiontemplate=None, closed_only=None, bartype=None, max_rows=100)	POST /timeseries を呼び出します。ティッカーごとに CSV ブロックを 1 つ返します（市場のバーの場合は timestamp,Open,High,Low,Close,Volume、それ以外は各ソース固有のフィールド）。最新の max_rows 行までに制限され（最大 1000 行）、総行数も記載されます。
get_latest(source, tickers, interval="1d", bars=10)	日付を指定せず、ティッカーごとに最新の N 本のバーを取得します。

get_timeseries／get_latest の各呼び出しは、AuraStream API を 1 回呼び出します。

公開されているソース：

グループ	ソース
暗号資産	binance、bybit、kraken、deribit、kucoin、dydx、hyperliquid、lyra（Derive）；独自のキーを使用：coinapi；Nemeton のサブスクリプションを利用：nemeton（注文板シグナル）
株式、FX、先物、CFD	yahoo；独自のアカウントを使用：oanda、alpaca、polygon、firstrate、tradestation、cityindex
マクロ経済とエネルギー	treasury、worldbank、sdmx（BIS、ECB、IMF、OECD など）、econcalendar（米国の発表時刻）、fedtext（FOMC の声明、議事録、FRB のスピーチ）、wasde（USDA の作物予測）；無料のキーを使用：fred、eia、bea（PCE、所得、GDP）；独自のキーを使用：tradingeconomics、nasdaq
ファンダメンタルズ	edgar（インサイダー取引、報告済み財務情報、決算関連の提出書類、予定売却（144）、8-K イベント、フェイル・トゥ・デリバー、13D／13G の持ち分、13F 保有銘柄、ファンドおよび ETF の保有銘柄（N-PORT）と議決権行使（N-PX））、usaspending（企業別の連邦政府契約）、warn（レイオフ通知）；独自のキーを使用：finnhub
ポジショニングと資金フロー	cftc（トレーダーの建玉報告）、netshort（EU の空売りポジション）、hmrc、comext、hktrade；無料のキーを使用：uscensus
暗号資産のファンダメンタルズとニュース	defillama、gdelt；無料のキーを使用：coingecko
天気と旅行	openmeteo、degreedays（暖房および冷房度日）、tsa（1 日あたりの航空旅客数）；独自のキーを使用：visualcrossing

日付は YYYY-MM-DD 形式です。インターバルは API の仕様に従います。大文字の M は分、小文字の m は月を表します（15M = 15 分、1m = 1 か月）。サーバーは、API を呼び出す前に、インターバル、データ型、パラメーターが各ソースのドキュメントに記載された値に沿っているか確認します。

インストール

Python 3.10 以降が必要です。

pip install aurastream-mcp

または、uv を使ってインストールせずに実行できます：uvx aurastream-mcp。

これにより、aurastream-mcp コマンドがインストールされます。aurastream-mcp --help で動作を確認してください。

設定

すべてのシークレットは環境変数から取得します。プロバイダーの認証情報がツールの引数になることは決してないため、チャットやモデルを経由することはありません。

変数	必要な用途
AURASTREAM_API_KEY	すべての機能。ダッシュボードから無料のキーを取得してください。
OANDA_ACCOUNT_ID, OANDA_TOKEN	oanda
OANDA_ENVIRONMENT	oanda、省略可能：practice（デフォルト）または live
ALPACA_API_KEY, ALPACA_SECRET_KEY	alpaca
POLYGON_API_KEY	polygon
FRED_API_KEY	fred
FINNHUB_API_KEY	finnhub
FIRSTRATE_USER_ID	firstrate：API ダウンロード用に FirstRate Data から発行されるユーザー ID
EIA_API_KEY	eia（eia.govで無料取得できます）
CENSUS_API_KEY	uscensus：貿易と小売売上高（census.govで無料取得できます）
BEA_API_KEY	bea（apps.bea.govで無料取得できます）
EDGAR_USER_AGENT	edgar と econcalendar（BLS）：氏名と連絡先メールアドレス（例：Your Company [email protected]）。SEC により必須です。登録は不要です。
NEMETON_API_KEY	nemeton：Nemeton のサブスクリプションで発行されるキー
COINAPI_KEY	coinapi
COINGECKO_API_KEY または COINGECKO_DEMO_API_KEY	coingecko：Pro キー、または無料の Demo キー（直近 365 日分のみ）
NASDAQ_DATA_LINK_API_KEY	nasdaq
TRADINGECONOMICS_API_KEY	tradingeconomics
TRADESTATION_CLIENT_ID, TRADESTATION_CLIENT_SECRET, TRADESTATION_REFRESH_TOKEN	tradestation
CITYINDEX_USERNAME, CITYINDEX_PASSWORD, CITYINDEX_APP_KEY	cityindex
VISUALCROSSING_API_KEY	visualcrossing
OPENMETEO_API_KEY	openmeteo、省略可能：設定されている場合に送信されます

気象ソースでは、場所を 緯度,経度 のティッカーとして指定します（例：48.85,2.35）。

使用するものだけを設定してください。list_sources を使うと、設定済みのソースがモデルに通知されます。

Claude Desktop

claude_desktop_config.json を編集します（Settings > Developer > Edit Config）：

{
  "mcpServers": {
    "aurastream": {
      "command": "aurastream-mcp",
      "env": {
        "AURASTREAM_API_KEY": "your-aurastream-key",
        "OANDA_ACCOUNT_ID": "101-004-12345678-001",
        "OANDA_TOKEN": "your-oanda-token"
      }
    }
  }
}

Claude Desktop がコマンドを見つけられない場合は、フルパスを使用してください（例：C:\\Users\\you\\venv\\Scripts\\aurastream-mcp.exe または /Users/you/venv/bin/aurastream-mcp）。その後、Claude Desktop を再起動してください。

Claude Code

claude mcp add aurastream -e AURASTREAM_API_KEY=your-aurastream-key -- aurastream-mcp

認証情報が必要なソースには -e FRED_API_KEY=... などを追加し、すべてのプロジェクトで利用できるようにするには --scope user を追加してください。

ホスト型サーバー（インストール不要）

Unbiased Alpha は https://aurastream.unbiased-alpha.com/mcp で共有インスタンスを提供しています。リモート MCP サーバーに対応する任意のクライアントから接続し、ご自身の AuraStream キーを送信してください：

• ヘッダーとして：x-api-key: <key> または Authorization: Bearer <key>、または
• ヘッダーを設定できないクライアント（ChatGPT）の場合は、URL に含めます：https://aurastream.unbiased-alpha.com/mcp?api_key=<key>。この URL を見た人は誰でもキーを使用できるため、キーそのものと同様に慎重に扱ってください。

Claude Code：

claude mcp add --transport http aurastream https://aurastream.unbiased-alpha.com/mcp --header "x-api-key: your-key"

ホスト型サーバーにはプロバイダーのキーが保存されないため、ご自身のプロバイダーアカウントが必要なソース（FRED、Polygon、Nemeton、および上の表にあるその他のソース）は、ローカルインストールでのみ利用できます。プロバイダーキーが不要なソースはすべて利用できます。

ChatGPT（リモートコネクター）

最も手早い方法は、上記のホスト型サーバーを使うことです。https://aurastream.unbiased-alpha.com/mcp?api_key=<your key> をコネクターとして追加します（Settings > Connectors、開発者モード）。代わりに自分で実行する場合：

ChatGPT は HTTPS 経由でリモート MCP サーバーとのみ通信するため、サーバーをアクセス可能な場所で HTTP モードで実行し、その URL をコネクターとして登録してください。

AURASTREAM_API_KEY=your-key aurastream-mcp --http --host 127.0.0.1 --port 8000
# endpoint: http://127.0.0.1:8000/mcp

パブリック HTTPS URL を提供するもの（TLS 対応のリバースプロキシや、Cloudflare Tunnel、ngrok などのトンネル）の背後に配置し、受け入れるパブリックホスト名をサーバーに指定します。

aurastream-mcp --http --port 8000 --allowed-host mcp.example.com

そのうえで、ChatGPT に https://mcp.example.com/mcp を追加します。ほかの Host ヘッダーを含むリクエストは拒否されます（DNS リバインディング対策）。

HTTP モードでの API キーの仕組み。 クライアントが x-api-key: <key>、Authorization: Bearer <key>、または URL の ?api_key=<key> を送信すると、そのキーが使用されます。それ以外の場合、サーバーは AURASTREAM_API_KEY にフォールバックします。このフォールバックによって現在 ChatGPT は動作しますが、URL を知っている人なら誰でも、あなたの利用枠を消費し、プロバイダーの認証情報を使用できます。HTTP モードは単一ユーザー向けのセルフホストとして扱ってください。URL を非公開にするか、独自の認証の背後に配置してください。各ユーザーが自分のキーを持ち込む場合は、--require-client-key を指定してフォールバックを無効にしてください。プロバイダーの認証情報は常にサーバーの環境変数から取得されます。

その他のオプション

aurastream-mcp [--http] [--host HOST] [--port PORT] [--path /mcp]
               [--allowed-host HOST ...] [--require-client-key] [--json-response]

AURASTREAM_API_URL はエンドポイントを上書きします（テストに便利です）。

プロンプトの例

• 「AuraStream には外国為替のどのようなデータソースがありますか？」
• 「Binance から 2025 年の日次 BTCUSDT と ETHUSDT を取得し、30 日ローリング相関を計算してください。」
• 「Oanda の EUR_USD の直近 20 時間足を表示してください。」
• 「FRED から 2015 年以降の UNRATE と DFF を取得し、両者の推移を説明してください。」
• 「2025 年 6 月の Binance BTCUSDT 無期限契約の資金調達率を表示してください。」
• 「金先物の運用資金ポジション（CFTC）は、2020 年以降どのように変化しましたか？」
• 「2024 年に AAPL のインサイダーで株式を売買したのは誰ですか？」
• 「2020 年以降のスイス向け英国金輸出額を月ごとに表示してください。」
• 「直近 6 か月分の SPY と QQQ の日次データを Yahoo から取得し、最大ドローダウンを比較してください。」

制限事項

• リアルタイム配信ではなく、過去のデータです。最後のバーはまだ形成中の場合があります。
• すべてのデータ呼び出しは、毎月の AuraStream 利用枠にカウントされます（無料プラン：月 500 回）。上限に達するとツールがその旨を通知し、毎月 1 日の 00:00 UTC にリセットされます。無料プランでは、1 秒あたり約 1 件のリクエストも可能です。
• モデルのコンテキストを管理しやすくするため、結果はティッカーごとに上限があります（デフォルトは 100 行、最大 1000 行）。長期間にわたる細かな履歴には、REST API または Python クライアントを直接使用してください。
• API は 120 秒後にタイムアウトします。非常に大きなリクエストは分割してください。
• 対応する時間間隔はデータソースによって異なります（ドキュメントを参照）。

既知の問題

• バー以外のデータ（資金調達、注文・ポジションブック、取引、クォート、決算、Finnhub の財務データ、マクロ、ポジショニング、取引データソース）は、汎用的なテーブルとして表示されます。
• 複数のデータソースでは、対象期間のタイムスタンプが付与されますが、公開は後日です（EIA、EDGAR の受渡し未了データ、取引データソース）。list_sources に遅延が記載されています。バックテストの前にデータをシフトしてください。
• GDELT の検索クエリには GDELT 自体によるスロットリングが適用されます。期間を短くしてください。dataset="themes" はスロットリングされません。

開発

python -m venv .venv
.venv/Scripts/activate        # or: source .venv/bin/activate
pip install -e ".[test]"
pytest

テストではすべての HTTP 呼び出しがモックされるため、API キーは不要です。

ライセンス

MIT。LICENSE を参照してください。