📈 Nasdaq Data Link MCP 🤖

由社区开发和维护的 模型上下文协议（MCP） 服务，为大模型提供访问 Nasdaq Data Link 的能力。专为搭配兼容 MCP 的客户端使用而构建。

本项目旨在通过自然语言界面和大模型（LLM），让用户轻松访问和探索 Nasdaq Data Link 丰富且宝贵的金融与经济数据集。

🐍 Nasdaq Data Link MCP 使用官方 Nasdaq/data-link-python SDK。

重要

这是一个开源项目，与 Nasdaq, Inc. 无关联，亦未获其认可。 Nasdaq® 是 Nasdaq, Inc. 的注册商标。

🌐 使用方法

Nasdaq Data Link MCP - 零售交易活动	Nasdaq Data Link MCP - 世界银行数据
Nasdaq Data Link MCP - Groq + DeepSeek R1 RTAT 10

安装并连接到兼容 MCP 的客户端（例如 Claude Desktop 或 Groq Desktop（测试版））后，此服务将提供 5 个核心工具，可用于任何 Nasdaq Data Link 数据库。

精选数据库：

• 世界银行 - 全球发展指标
• Equities 360 - 公司基本面和财务数据
• Nasdaq RTAT - 零售交易活动
• Nasdaq Fund Network (NFN) - 共同基金和 ETF
• ……以及通过数据集代码访问的 100 多个其他数据库

对话示例

你： 2022 年意大利的 GDP 是多少？ Claude： 搜索数据集，获取 WORLDBANK/GDP 数据

你： 展示 2024 年第一季度的 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 密钥即可运行。

---

🛠️ 工具

该服务提供 5 个适用于任何 Nasdaq Data Link 数据库的核心工具：

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 许可证 © 2025 Stefano Amorelli