Twelve Data

公式

Twelve DataのAPIと連携し、AIエージェント向けにリアルタイムおよび過去の金融市場データにアクセスします。

GitHub
86

Twelve Data MCPで何ができますか？

  • リアルタイムおよび履歴価格 — AAPLやBTC/USDなどの株式、ETF、外国為替、暗号通貨、コモディティの現在または過去の相場を尋ねます。
  • テクニカル指標 — 任意の対応シンボルについて、RSI、MACD、SMA、BBANDS、ATR、または60以上の他の指標をリクエストします。
  • ファンダメンタルズと企業アクション — 収益、配当、株式分割、財務諸表、会社概要、時価総額、または主要統計を取得します。
  • 市場ニュースとインテリジェンス — 企業ニュース、プレスリリース、市場の値動き、アナリスト評価、目標株価、または為替レートを取得します。
  • ファンドおよび規制データ — ETF/投資信託のプロフィール、保有銘柄、SEC/EDGAR提出書類、インサイダー取引、または機関投資家の保有状況にアクセスします。

ドキュメント

Twelve Data MCP サーバー

Claude、ChatGPT、その他のAIアシスタントを Twelve Data 金融APIに接続します。リアルタイムおよび履歴価格、60以上のテクニカル指標、ファンダメンタルズ、決算、配当、ETF、企業ニュース、市場の値動きなどに対応しています。

Twelve Data のアカウントが必要です。twelvedata.com でサインアップしてください。

利用方法は2つあります。ほとんどのユーザーはクラウドサーバー（オプション1）を利用してください — インストールは不要です。

オプション1 — クラウドサーバーを利用（推奨）

AIアシスタントをホスト型サーバーに接続します：

https://mcp.twelvedata.com/mcp

これだけです。インストールも、APIキーのコピー＆ペーストも不要です。接続するとブラウザウィンドウが開き、Twelve Data アカウントでログインします — 個人のAPIキーが自動的にリンクされ、アカウントに紐付けられたままになります。

追加方法

Claude（デスクトップ / Web）および ChatGPT はカスタムコネクタ / MCPサーバーをサポートしています：

  1. アシスタントの Connectors（または Integrations / MCP servers）設定を開きます。
  2. URL https://mcp.twelvedata.com/mcp で新しいコネクタを追加します。
  3. プロンプトが表示されたら Connect / Log in をクリックします — ブラウザで Twelve Data のログインページが開きます。
  4. 承認すれば完了です。「AAPLのRSIは？」 や 「TSLAの最新の決算を見せて」 のように質問してみてください。

正確なメニュー名はアプリやバージョンによって異なりますが、流れは常に同じです：URLを追加し、ブラウザのポップアップでログインします。

MCPホストはトークンを発行しません。コネクタURLは https://mcp.twelvedata.com/mcp です。クライアントは、そのURLの保護リソースメタデータに記載されている認可サーバーに従う必要があります。コネクタをホストのルート（404を返します）や、このホストの /register または /.well-known/oauth-authorization-server に向けないでください。

Perplexity（カスタムリモートコネクタ）

Perplexity Pro、Max、Enterprise ユーザーは、ホスト型サーバーをカスタムリモートコネクタとして追加できます。これはアカウントごとの設定であり、Perplexity の公開キュレーションディレクトリへの掲載ではありません。

  1. Perplexity で Account settings → Connectors → + Custom connector を開き、Remote を選択します。Enterprise では、管理者が先にカスタムコネクタを許可する必要がある場合があります。
  2. Name を Twelve Data に、MCP Server URL を https://mcp.twelvedata.com/mcp に設定します。
  3. 認証には OAuth、トランスポートには Streamable HTTP を選択します。Client ID と Client Secret は空白のままにして、Perplexity がサーバーの保護リソースメタデータに指定された認可サーバーで動的クライアント登録を使用できるようにします。
  4. Perplexity のカスタムコネクタの確認事項に同意し、Add をクリックします。次に Twelve Data コネクタカードをクリックして認証を開始し、Twelve Data アカウントにサインインしてアクセスを承認します。
  5. コネクタが有効になったら、次のプロンプトを試してください：
    • 「Twelve Data を使って AAPL のシンボルを検索して。」
    • 「Twelve Data を使って AAPL の最新のクォート（価格と出来高を含む）を取得して。」
    • 「Twelve Data を使って AAPL の過去5日間の日次終値を表示して。」
    • 「Twelve Data を使って AAPL の RSI を表示して。」

各ユーザーは自分の Twelve Data アカウントでサインインします。Enterprise 管理者がコネクタを共有する場合は、各メンバーに個別の認証を要求してください。Twelve Data のAPIキーをコネクタのAPIキー認証フィールドに貼り付けないでください。

OAuthウィンドウがブロックされた場合、ログインに失敗した場合、またはアイドル時間後にツールが停止した場合は、Twelve Data コネクタを開いて無効にし、再度有効にしてサインインしてください。コネクタをAPIキー認証に切り替えるのではなく、この方法で再接続してください。URLが末尾にスラッシュのない正確な https://mcp.twelvedata.com/mcp であること、および Twelve Data プランに要求されたデータが含まれていることを確認してください。現在の設定画面については Perplexity のカスタムリモートコネクタガイド を参照してください。

Codex（CLI、デスクトップ、IDE）

このリポジトリをインストールしたりAPIキーをコピーしたりせずに、ホスト型MCPサーバーを Codex に追加します：

codex mcp add twelvedata --url https://mcp.twelvedata.com/mcp
codex mcp list

add コマンドでOAuthが開始されます：ブラウザで Twelve Data のサインインを完了してください。後で再度承認が必要な場合は、codex mcp login twelvedata を実行します。Codex では、/mcp を使用して接続を確認し、「Twelve Data を使って AAPL の最新のクォートを取得して。」 や 「Twelve Data を使って AAPL の RSI を表示して。」 と質問してください。切断するには、codex mcp remove twelvedata を実行します。

公開プラグインリポジトリは https://github.com/MazeBraker/twelvedata-skills. です。スキルと同じホスト型MCPをインストールします：

codex plugin marketplace add https://github.com/MazeBraker/twelvedata-skills
codex plugin add twelvedata@twelvedata-skills

オプション2 — APIキーを使って自分で実行

自分のマシンでサーバーを実行したいですか？必要なのは Twelve Data APIキー だけです — OAuthの設定は不要です。twelvedata.com → ダッシュボード → API Keys で取得できます。

1. インストール

Python 3.10以上 が必要です（3.12推奨。macOSでは brew install python@3.12 または make python-install）。

make install

2. APIキーを追加

プロジェクトのルートに .env ファイルを作成し、キーをあなただけが読み取れるように設定します：

echo 'TWELVE_DATA_API_KEY=your_api_key_here' > .env
chmod 600 .env

サーバーは .env からキーを読み取り、すべてのリクエストでそれを使用します。ログイン手順は不要です。

3. stdio で接続

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json に追加：

{
  "mcpServers": {
    "twelvedata": {
      "command": "/path/to/mcp/.venv/bin/python",
      "args": ["/path/to/mcp/src/server.py"]
    }
  }
}

.venv/bin/python パスを使用してください（システムのPythonではなく — macOSには3.9が付属しており、このサーバーには3.10以上が必要です）。設定ファイルを編集した後、Claude Desktop を再起動してください。

Claude Code：

claude mcp add twelvedata -- /path/to/mcp/.venv/bin/python /path/to/mcp/src/server.py

4. HTTP で接続

make run           # serves http://localhost:8000/mcp

claude mcp add --transport http twelvedata http://localhost:8000/mcp

5. Docker で実行

docker build -t twelvedata-mcp .
docker run --rm --env-file .env -p 127.0.0.1:8000:8000 twelvedata-mcp

--env-file により、キーがシェル履歴に残りません。手順4と同様に http://localhost:8000/mcp に接続します。Docker ではOAuthログインはサポートされていません。

6. セキュリティ

  • make run と Docker は、/mcp を 認証なし で、デフォルトで 0.0.0.0 上で提供します。
  • すべての呼び出しは あなたの 資格情報で処理されます。
  • ポートに到達できる人は誰でも auth_status と oauth_configure を呼び出すことができます。これには、DNSリバインディングによる、開いたWebページも含まれます。デフォルトのバインドは Host も Origin ヘッダーもチェックしないためです。
  • MCP_HOST=127.0.0.1 make run はサーバーをローカルに保ち、MCP SDK の Host と Origin チェックを有効にします。
  • MCP_HOST=127.0.0.1 を使用すると、ngrok は --host-header=rewrite で開始した場合にのみ機能します。

7. トラブルシューティング

最初にクライアントから auth_status を呼び出してください。APIキーが設定されているか、保存されたトークン、検出されたホスト、リダイレクトURIが表示されます — 通常、何が不足しているかを確認するのに十分です。

できること

  • 価格 — 株式、ETF、外国為替、暗号通貨、商品（リアルタイム＆履歴）
  • テクニカル指標 — RSI、MACD、SMA、BBANDS、ATR、その他60以上
  • ファンダメンタルズ — 財務諸表、決算、配当、株式分割、企業プロフィール、時価総額、主要統計、IPOカレンダー
  • ファンド — ETF＆投資信託のプロフィール、パフォーマンス、保有銘柄、リスク
  • ニュース — 企業ニュース＆プレスリリース
  • 市場インテリジェンス — 値動きの大きい銘柄、為替レート、アナリスト評価、目標株価
  • 規制 — SEC/EDGAR提出書類、インサイダー取引、機関投資家の保有状況

シンボル形式：株式 AAPL、暗号通貨 BTC/USD、外国為替 EUR/USD。

パートナー

独自の公開インスタンスを実行したり、専用のOAuthログインを設定したりしますか？それはパートナー契約です — twelvedata.com までご連絡ください。セットアップガイドとOAuth資格情報を提供します。