📈 Nasdaq Data Link MCP 🤖

大規模言語モデルからNasdaq Data Linkにアクセスできる、コミュニティが開発・保守するModel Context Protocol（MCP）サーバーです。MCP 対応のクライアントでの利用を想定しています。

このプロジェクトは、自然言語インターフェースと大規模言語モデル（LLM）を通じて、Nasdaq Data Link の豊富で価値ある金融・経済データセットに簡単にアクセスし、探索できるようにすることを目指しています。

🐍 Nasdaq Data Link MCP は公式のNasdaq/data-link-python SDK を使用しています。

重要

これはオープンソースプロジェクトであり、Nasdaq, Inc. とは提携関係になく、同社から承認を受けていません。 Nasdaq® は Nasdaq, Inc. の登録商標です。

🌐 使用方法

Nasdaq Data Link MCP - Retail Trading Activity	Nasdaq Data Link MCP - World Bank Data
Nasdaq Data Link MCP - Groq + DeepSeek R1 RTAT 10

インストールしてMCP対応クライアント（例：Claude DesktopまたはGroq Desktop (beta)）に接続すると、このサーバーはあらゆるNasdaq Data Link データベースで動作する5つの基本ツールを提供します。

主なデータベース：

• World Bank - 世界の開発指標
• Equities 360 - 企業の基礎情報と財務データ
• Nasdaq RTAT - 個人投資家の取引活動
• Nasdaq Fund Network (NFN) - 投資信託とETF
• …データセットコードで利用できる100以上のデータベース

会話の例

あなた： 2022年のイタリアのGDPはいくらでしたか？ Claude： データセットを検索し、WORLDBANK/GDP データを取得します

あなた： 2024年第1四半期のAppleの株価データを見せてください Claude： 日付フィルターを使ってWIKI/AAPL データセットを取得します

あなた： CO₂排出量に関するデータセットはありますか？ Claude： 「CO2 emissions」でデータセットを検索します

あなた： Tesla のデータをJSON形式でエクスポートしてください Claude： データセットをJSON形式でエクスポートします

---

📦 インストール

1. リポジトリをクローンする

git clone https://github.com/stefanoamorelli/nasdaq-data-link-mcp.git
cd nasdaq-data-link-mcp

2. 必要な要件をインストールする

Python 3.13+ と mcp CLI が必要です。

uv init mcp
uv add "mcp[cli]"

MCP SDK：https://github.com/modelcontextprotocol/python-sdk Nasdaq Data Link SDK：https://github.com/Nasdaq/data-link-python

3. API キーを取得する

https://data.nasdaq.com/ に登録し、API キーをコピーします。

4. 環境を設定する

cp .env.example .env

次に、.env を編集して API キーを追加します。

NASDAQ_DATA_LINK_API_KEY=your_api_key_here

続いて、PYTHONPATH を設定します。

PYTHONPATH=/path/to/your/local/cloned/repo/nasdaq-data-link-mcp

5. MCP サーバーをインストールする

uv run mcp install nasdaq_data_link_mcp_os/server.py --env-file .env --name "Nasdaq Data Link MCP Server" --with nasdaq-data-link --with pycountry

これにより、サーバーが MCP クライアント（Claude Desktop など）に登録されます。

---

🧪 テスト

テストスイートを実行します。

python -m pytest tests/ -v

テストスイートには次の内容が含まれます。

• 基本機能のテスト
• モジュールのインポート確認
• パラメーターの検証
• エラー処理
• 統合テスト

基本機能の確認では、API キーがなくてもテストを実行できるように設計されています。

---

🛠️ ツール

このサーバーは、Nasdaq Data Link のあらゆるデータベースで使用できる5つの基本ツールを公開します。

search_datasets

キーワードでデータセットを検索します。

例：

# Find GDP datasets
search_datasets(query="GDP")

# Search for oil prices
search_datasets(query="oil prices")

# Find retail trading data
search_datasets(query="retail trading")

# Search for fund data
search_datasets(query="mutual funds")

get_dataset

任意の日付フィルターを指定して、特定のデータセットからデータを取得します。

例：

# Get Apple stock data for Q1 2024
get_dataset(dataset_code="WIKI/AAPL", start_date="2024-01-01", end_date="2024-03-31")

# Get World Bank GDP data
get_dataset(dataset_code="WORLDBANK/GDP_MKTP_CD")

# Get retail trading activity
get_dataset(dataset_code="NDAQ/RTAT", start_date="2024-03-01")

# Get company fundamentals
get_dataset(dataset_code="QOR/STATS_MSFT")

# Get fund price history
get_dataset(dataset_code="NFN/MFRPH_ABCDX", start_date="2024-01-01", end_date="2024-12-31")

get_dataset_metadata

データをダウンロードせずに、データセットのメタデータを取得します。

例：

# Check GDP dataset structure
get_dataset_metadata(dataset_code="WORLDBANK/GDP_MKTP_CD")

# View available columns for Apple stock
get_dataset_metadata(dataset_code="WIKI/AAPL")

# Inspect fund data structure
get_dataset_metadata(dataset_code="NFN/MFRFM")

list_databases

Nasdaq Data Link で利用可能なデータベースを一覧表示します。

例：

list_databases()

export_dataset

データセットをさまざまな形式（CSV、JSON、XML）でエクスポートします。

例：

# Export Apple data as JSON
export_dataset(dataset_code="WIKI/AAPL", output_format="json", start_date="2024-01-01")

# Export to CSV with date range
export_dataset(dataset_code="WORLDBANK/GDP_MKTP_CD", output_format="csv", start_date="2020-01-01", end_date="2023-12-31")

# Export as XML
export_dataset(dataset_code="NDAQ/RTAT", output_format="xml")

---

🧪 MCP の開発とデバッグ

UI を使ってサーバーをローカルでテストするには、次を実行します。

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

これにより MCP 開発インターフェースが開き、ツールを手動で呼び出し、結果を確認して、問題を調査できます。

---

📊 アーキテクチャ図

graph TD
  subgraph "Local Machine"
    A[MCP Server: Nasdaq Data Link MCP] --> C[MCP Client, ie. Claude Desktop]
  end

  C -->|user prompt| D[LLM ie. Claude 3.7 Sonnet]
  D -->|calls tool| A
  A -->|fetches data| B[Nasdaq Data Link API]
  B -.-> E[Retail Trading Activity Tracker]
  B -.-> F[World Bank Metadata]
  B -.-> N[Trade Summary NDAQ/TS]

  subgraph "Nasdaq Fund Network (NFN)"
    O1[Fund Master MFRFM]
    O2[Fund Information MFRFI]
    O3[Share Class Master MFRSM]
    O4[Share Class Info MFRSI]
    O5[Price History MFRPH/MFRPH10]
    O6[Performance MFRPS/MFRPRB/MFRPA]
    O7[Fees & Expenses MFRPM]
    O8[Monthly Flows MFRMF]
  end

  B -.-> O1
  B -.-> O2
  B -.-> O3
  B -.-> O4
  B -.-> O5
  B -.-> O6
  B -.-> O7
  B -.-> O8

  subgraph " "
    G[Statistics NDAQ/STAT]
    H[Fundamentals NDAQ/FS]
    I[Fundamental Details NDAQ/FD]
    J[Balance Sheet NDAQ/BS]
    K[Cash Flow NDAQ/CF]
    L[Corporate Actions NDAQ/CA]
    M[Reference Data NDAQ/RD]
  end

B -.->|Equities 360| G

---

📚 参考資料

• Model Context Protocol Python SDK
• Nasdaq Data Link Python SDK

---

📖 引用

ヒント

このプロジェクトを研究や業務で使用する場合は、CITATION.cff ファイル、または APA 形式を使用して引用してください。

Amorelli, S. (2025). Nasdaq Data Link MCP (Model Context Protocol) Server [Computer software]. GitHub. https://github.com/stefanoamorelli/nasdaq-data-link-mcp

---

📄 ライセンス

MIT License © 2025 Stefano Amorelli