MCP

🚀 Twelve Data MCP Server

Twelve Data MCP Serverは、Twelve Data APIとシームレスに統合し、金融市場データにアクセスすることができます。株式、外国為替ペア、暗号通貨の履歴時系列データ、リアルタイム相場、および商品メタデータの取得を可能にします。

注意: このサーバーは現在初期開発段階です。Twelve Data APIの更新に伴い、機能やツールは進化する可能性があります。

🚀 クイックスタート

Twelve Data MCP Serverを使用するには、まずTwelve DataからAPIキーを取得する必要があります。

1. Twelve Data Sign Upにアクセスします。
2. アカウントを作成するか、すでに持っている場合はログインします。
3. ダッシュボードに移動し、APIキーをコピーします。

重要: 特定のエンドポイントまたは市場へのアクセスは、Twelve Dataのサブスクリプションプランによって異なる場合があります。

✨ 主な機能

ツール

1. time_series シンボルの履歴価格データを取得します。

   • 入力:
     • symbol (文字列): ティッカー、例: AAPL
     • interval (文字列): データ間隔、例: 1min, 1day
     • start_date (文字列、オプション): ISO-8601形式の開始タイムスタンプ
     • end_date (文字列、オプション): ISO-8601形式の終了タイムスタンプ
   • 戻り値: OHLCVバーの配列。

2. price シンボルの最新価格を取得します。

   • 入力:
     • symbol (文字列)
   • 戻り値: 最新の価格相場。

3. stocks 利用可能な株式商品をリストします。

   • 入力:
     • exchange (文字列、オプション): フィルタリングする取引所コード
   • 戻り値: 株式メタデータの配列。

4. forex_pairs 利用可能な外国為替ペアをリストします。

   • 入力: なし
   • 戻り値: 外国為替ペアメタデータの配列。

5. cryptocurrencies 利用可能な暗号通貨をリストします。

   • 入力: なし
   • 戻り値: 暗号通貨メタデータの配列。

📦 インストール

UVを使用する場合（推奨）

uvxを使用して、ローカルにインストールせずに直接実行できます。

uvx mcp-server-twelve-data --help

pipを使用する場合

pipを介してサーバーをインストールします。

pip install mcp-server-twelve-data
python -m mcp_server_twelve_data --help

📚 ドキュメント

Claude Desktopとの統合

claude_desktop_config.jsonに以下のスニペットを追加します。

{
  "mcpServers": {
    "twelvedata": {
      "command": "uvx",
      "args": ["--reinstall", "mcp-server-twelve-data", "--apikey", "YOUR_API_KEY"]
    }
  }
}

または、リモートHTTPサーバーを使用する場合は、以下を追加します。

{
  "mcpServers": {
    "twelvedata-remote": {
      "command": "npx",
      "args":    [
        "mcp-remote", "https://mcp.twelvedata.com/mcp/",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "apikey YOUR_API_KEY"
      }
    }
  }
}

Claude DesktopをTwelve Data MCP Serverに接続するのがいかに簡単かをご覧ください。

VS Codeとの統合

自動セットアップ（UVを使用）

手動セットアップ

手動で設定する場合は、User Settings (JSON) に以下を追加します。

{
  "mcp": {
    "servers": {
      "twelvedata": {
        "command": "uvx",
        "args": ["mcp-server-twelve-data", "-t", "streamable-http"]
      }
    }
  }
}

🔧 技術詳細

デバッグ

トラブルシューティングにはMCP Inspectorを使用します。

npx @modelcontextprotocol/inspector uvx mcp-server-twelve-data

開発ガイド

1. ローカルテスト: デバッグで説明したように、MCP Inspectorを利用します。
2. Claude Desktop: claude_desktop_config.jsonを更新して、ローカルソースパスを参照するようにします。

Dockerの使用

Dockerを使用してサーバーをビルドし、実行します。

docker build -t mcp-server-twelve-data .
docker run --rm mcp-server-twelve-data --apikey YOUR_API_KEY

📄 ライセンス

このMCPサーバーはMITライセンスの下で提供されています。詳細については、LICENSEファイルを参照してください。