<div align="center">

📈 Nasdaq Data Link MCP 🤖

</div>

<div align="center">

</div>

一个由社区开发和维护的 模型上下文协议 (MCP) 服务器，提供对 Nasdaq Data Link 的访问。专为与 MCP 兼容的 客户端 一起使用而构建。

该项目旨在通过自然语言界面和大型语言模型 (LLM) 轻松访问和探索 Nasdaq Data Link 广泛且有价值的金融和经济数据集。

🐍 本项目使用官方的 nasdaq/data-link-python SDK

免责声明： 这是一个开源项目，不隶属于 Nasdaq, Inc.，也未获得其认可。 Nasdaq® 是 Nasdaq, Inc. 的注册商标。

🌐 用法

Nasdaq Data Link MCP - 零售交易活动	Nasdaq Data Link MCP - 世界银行数据

安装并连接到 MCP 兼容的客户端（例如，Claude Desktop）后，此服务器会公开多个工具，供您的 AI 助手用于获取数据。

在此版本 (0.1.0) 中，该项目支持以下数据库：

• Nasdaq Data Link 上的世界银行数据集（可免费用于个人用途）
• Nasdaq RTAT（免费提供预览，完整数据需要订阅）
• Equities 360（公司统计数据和基本数据）

示例对话可能包括：

你： 昨天零售商交易最多的股票是什么？ Claude： 调用 get_rtat(<yesterday>) 并返回相关匹配项

或者：

你： 2022 年意大利的 GDP 是多少？ Claude： 让我查一下... 调用 get_indicator_value 工具 Claude： 2022 年意大利的 GDP 大约是 ... 万亿美元。

或者：

你： 列出所有与 CO₂ 排放相关的指标。 Claude： 调用 search_worldbank_indicators("CO2") 并返回相关匹配项

或者：

你： 微软的市值和市盈率是多少？ Claude： 调用 get_stock_stats(symbol="MSFT") 并显示关键统计数据

---

📦 安装

1. 克隆存储库

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

2. 安装要求

您需要 Python 3.10+ 和 mcp CLI。

pip install mcp nasdaq-data-link pycountry

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. 下载 World Bank metadata CSV（可选：仅当您计划使用 World Bank 数据库时）

从 Nasdaq Data Link 下载 World Bank metadata：

并将其另存为以下目录中的 metadata.csv：

nasdaq-data-link-mcp/src/resources/world_data_bank/metadata/metadata.csv

5. 配置环境

cp .env.example .env

然后编辑 .env 并添加您的 API 密钥：

NASDAQ_DATA_LINK_API_KEY=your_api_key_here

6. 启动 MCP 服务器

mcp install nasdaq_data_link_mcp_os/server.py --env-file .env --name "Nasdaq Data Link MCP Server"

这会将服务器注册到您的 MCP 客户端（例如，Claude Desktop）。

---

🛠️ 工具

安装后，以下工具将公开给 MCP 客户端：

---

<details> <summary><strong>📈 零售交易活动追踪器</strong></summary>

get_rtat10

检索特定日期和可选股票代码的零售交易活动追踪器 10 (RTAT10) 数据。

{
  "action": "tool",
  "name": "get_rtat10",
  "params": {
    "dates": "2025-03-31,2025-03-28,2025-03-27",
    "tickers": "TSLA,TQQQ,SQQQ"
  }
}

从 Nasdaq Data Link 返回给定日期和股票代码的 RTAT10 数据。

---

get_rtat

检索特定日期和可选股票代码的零售交易活动 (RTAT) 数据。

{
  "action": "tool",
  "name": "get_rtat",
  "params": {
    "dates": "2025-03-31,2025-03-28,2025-03-27",
    "tickers": "TSLA,TQQQ,SQQQ"
  }
}

从 Nasdaq Data Link 返回给定日期和股票代码的 RTAT 数据。

</details>

---

<details> <summary><strong>📊 世界银行工具</strong></summary>

get_indicator_value

获取特定指标和国家/地区的值。

{
  "action": "tool",
  "name": "get_indicator_value",
  "params": {
    "country": "Italy",
    "indicator": "NY.GDP.MKTP.CD"
  }
}

返回该指标的最新值。

---

country_code

返回 ISO 3 字母国家/地区代码（例如，意大利的 "ITA"）。

{
  "action": "tool",
  "name": "country_code",
  "params": {
    "countryName": "Italy"
  }
}

---

list_worldbank_indicators

返回所有 1500 多个可用指标的列表。

{
  "action": "tool",
  "name": "list_worldbank_indicators"
}

---

search_worldbank_indicators

按关键字搜索指标。

{
  "action": "tool",
  "name": "search_worldbank_indicators",
  "params": {
    "keyword": "population"
  }
}

</details>

---

<details> <summary><strong>📈 Equities 360 工具</strong></summary>

get_stock_stats

从 Nasdaq Equities 360 数据库检索公司的综合统计数据。

{
  "action": "tool",
  "name": "get_stock_stats",
  "params": {
    "symbol": "MSFT"
  }
}

或使用 FIGI：

{
  "action": "tool",
  "name": "get_stock_stats",
  "params": {
    "figi": "BBG000BPH459"
  }
}

返回公司统计数据，包括市值、市盈率、52 周高点/低点、股息信息等。

---

list_stock_stat_fields

列出股票统计数据库中所有可用字段及其描述。

{
  "action": "tool",
  "name": "list_stock_stat_fields"
}

返回有关可以通过 get_stock_stats 工具查询的所有可用字段的信息。

</details>

---

🧪 MCP 开发与调试

要使用 UI 在本地测试服务器：

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

这将打开 MCP 开发界面，您可以在其中手动调用工具、检查结果和进行故障排除。

---

📊 架构图

graph TD
  subgraph "本地机器"
    A[MCP 服务器：Nasdaq Data Link MCP] --> C[MCP 客户端，例如 Claude Desktop]
  end

  C -->|用户提示| D[LLM 例如 Claude 3.7 Sonnet]
  D -->|调用工具| A
  A -->|获取数据| B[Nasdaq Data Link API]
  B -.-> E[零售交易活动追踪器]
  B -.-> F[世界银行元数据]
  B -.-> G[Equities 360 统计数据]

---

📚 参考

• 模型上下文协议 Python SDK
• Nasdaq Data Link Python SDK

---

📄 许可证

MIT 许可证 © 2025 Stefano Amorelli