Nasdaq Data Link MCP

🚀 クイックスタート

このプロジェクトは、Nasdaq データリンクのデータを取得するための MCP サーバーを提供します。以下の手順に従って、サーバーをインストール、設定、起動してください。

📦 インストール

✨ MCP サーバーのインストール

pip install nasdaq-data-link-mcp

🔧 環境変数の設定

.env ファイルを編集し、以下の内容を追加してください。

NASDAQ_API_KEY=your_api_key_here
NASDAQ_ENVIRONMENT=development # オプション: production または sandbox

🚀 MCP サービスの起動

以下のコマンドを実行して、MCP サーバーを起動します。

mcp start nasdaq_data_link_mcp_os/server.py --env-file .env

💻 使用例

✨ 統計ツールの呼び出し

from nasdaq_data_link import get_stock_statistics

statistics = get_stock_statistics(
    symbol="AAPL",
    time_series="1D",  # オプション: 1H, 1D, 1W, 1M, 1Y
)

✨ 価格データツールの呼び出し

from nasdaq_data_link import get_stock_price

price_data = get_stock_price(
    symbol="MSFT",
    start_date="2023-01-01",
    end_date="2023-12-31",
)

✨ 市場データツールの呼び出し

from nasdaq_data_link import get_market_index

market_data = get_market_index(
    index_id="NDX",  # オプション: SPX, NDX, DJI など
)

🛠️ MCP の開発とデバッグ

🎈 ローカル開発環境の起動

mcp dev nasdaq_data_link_mcp_os/server.py --env-file .env

これにより、MCP 開発画面が開き、手動でツールを呼び出し、結果を確認し、障害排除を行うことができます。

📚 詳細ドキュメント

📊 システムアーキテクチャ図

graph TD
  subgraph "ローカルコンピュータ"
    A[MCP サーバー: ナスダックデータリンク MCP] --> C[MCP クライアント、例えば Claude デスクトップ]
  end

  C -->|ユーザーの指示| D[大規模言語モデル、例えば Claude 3.7 チャンドラー]
  D -->|ツールの呼び出し| A
  A -->|データの取得| B[Nasdaq データリンク API]
  B -.-> E[小売取引活動トラッカー]
  B -.-> F[世界銀行メタデータ]
  B -.-> N[貿易摘要 NDAX/TS]

  subgraph " "
    G[統計 NDAX/STAT]
    H[ファンダメンタル NDAX/FS]
    I[詳細ファンダメンタル情報 NDAX/FD]
    J[バランスシート NDAX/BS]
    K[キャッシュフロー NDAX/CF]
    L[企業行動 NDAX/CA]
    M[参照データ NDAX/RD]
  end

B -.->|株式 360| G

📚 参考資料

• モデルコンテキストプロトコル Python SDK
• ナスダックデータリンク Python SDK

📄 ライセンス

MIT ライセンス © 2025 Stefano Amorelli