纳斯达克数据链接器-MCP
项目介绍
📈 Nasdaq 数据链接 MCP 🤖
</div> <div align="center">
由社区开发和维护的 模型上下文协议（MCP） 服务器，提供大型语言模型访问 Nasdaq 数据链接 的途径。适用于与 MCP 兼容的 客户端。
该项目旨在通过自然语言界面和大型语言模型（LLMs）轻松访问和探索 Nasdaq 数据链接广泛的金融和经济数据集。
🐍 Nasdaq 数据链接 MCP 使用官方的 Nasdaq/data-link-python SDK。
[!IMPORTANT] 这是一个开源项目，不隶属于或得到 Nasdaq, Inc. 的支持。Nasdaq® 是 Nasdaq, Inc. 的注册商标。
🌐 使用方法
| Nasdaq 数据链接 MCP - 零售交易活动 | Nasdaq 数据链接 MCP - 世界银行数据 |
| Nasdaq 数据链接 MCP - Groq + DeepSeek R1 RTAT 10 |
安装并连接到兼容 MCP 的客户端（例如，Claude 桌面版，或 Groq 桌面版（测试版） 后，此服务器提供了 5 个基本工具，可与任何 Nasdaq 数据链接数据库配合使用。
特色数据库：
- 世界银行 - 全球发展指标
- Equities 360 - 公司基本面和财务信息
- Nasdaq RTAT - 零售交易活动
- Nasdaq 基金网络（NFN） - 共同基金和 ETFs
- ...以及更多超过 100 个数据库通过数据集代码
您： 2022 年意大利的 GDP 是多少？ Claude： 搜索数据集，获取 WORLDBANK/GDP 数据
您： 显示苹果股票在 2024 年第一季度的数据 Claude： 获取 WIKI/AAPL 数据集并应用日期过滤器
您： 关于 CO₂ 排放有哪些数据集可用？ Claude： 搜索数据集中“CO2 排放”
</details>您： 将特斯拉数据导出为 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 数据链接 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 数据链接 MCP 服务器" --with nasdaq-data-link --with pycountry
这将注册服务器与您的 MCP 客户端（例如，Claude 桌面版）。
🧪 测试
运行测试套件：
python -m pytest tests/ -v
测试套件包括：
- 基本功能测试
- 模块导入验证
- 参数验证
- 错误处理
- 集成测试
测试设计为无需 API 密钥即可进行基本功能验证。
🛠️ 工具
服务器暴露了 5 个基本工具，可与任何 Nasdaq 数据链接数据库配合使用：
search_datasets
按关键词搜索数据集。
示例：
# 查找 GDP 数据集
search_datasets(query="GDP")
# 搜索石油价格
search_datasets(query="石油价格")
# 查找零售交易数据
search_datasets(query="零售交易")
# 搜索基金数据
search_datasets(query="共同基金")
get_dataset
从特定数据集中获取数据，可选日期过滤器。
示例：
# 获取苹果股票在 2024 年第一季度的数据
get_dataset(dataset_code="WIKI/AAPL", start_date="2024-01-01", end_date="2024-03-31")
# 获取世界银行 GDP 数据
get_dataset(dataset_code="WORLDBANK/GDP_MKTP_CD")
# 获取零售交易活动
get_dataset(dataset_code="NDAQ/RTAT", start_date="2024-03-01")
# 获取公司基本面
get_dataset(dataset_code="QOR/STATS_MSFT")
# 获取基金价格历史
get_dataset(dataset_code="NFN/MFRPH_ABCDX", start_date="2024-01-01", end_date="2024-12-31")
get_dataset_metadata
获取数据集元数据而不下载数据。
示例：
# 检查 GDP 数据集结构
get_dataset_metadata(dataset_code="WORLDBANK/GDP_MKTP_CD")
# 查看苹果股票可用列
get_dataset_metadata(dataset_code="WIKI/AAPL")
# 检查基金数据结构
get_dataset_metadata(dataset_code="NFN/MFRFM")
list_databases
列出 Nasdaq 数据链接上的可用数据库。
示例：
list_databases()
export_dataset
以不同格式（CSV、JSON、XML）导出数据集。
示例：
# 将苹果数据导出为 JSON
export_dataset(dataset_code="WIKI/AAPL", output_format="json", start_date="2024-01-01")
# 在指定日期范围内导出为 CSV
export_dataset(dataset_code="WORLDBANK/GDP_MKTP_CD", output_format="csv", start_date="2020-01-01", end_date="2023-12-31")
# 导出为 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 "本地机器"
A[MCP 服务器：Nasdaq 数据链接 MCP] --> C[MCP 客户端，如 Claude 桌面版]
end
C -->|用户提示| D[LLM 如 Claude 3.7 Sonnet]
D -->|调用工具| A
A -->|获取数据| B[Nasdaq 数据链接 API]
B -.-> E[零售交易活动追踪器]
B -.-> F[世界银行元数据]
B -.-> N[交易摘要 NDAQ/TS]
subgraph "Nasdaq 基金网络 (NFN)"
O1[基金主数据 MFRFM]
O2[基金信息 MFRFI]
O3[份额主数据 MFRSM]
O4[份额信息 MFRSI]
O5[价格历史 MFRPH/MFRPH10]
O6[表现 MFRPS/MFRPRB/MFRPA]
O7[费用及支出 MFRPM]
O8[月度流量 MFRMF]
end
B -.-> O1
B -.-> O2
B -.-> O3
B -.-> O4
B -.-> O5
B -.-> O6
B -.-> O7
B -.-> O8
subgraph " "
G[统计 NDAQ/STAT]
H[基本面 NDAQ/FS]
I[基本面详情 NDAQ/FD]
J[资产负债表 NDAQ/BS]
K[现金流量 NDAQ/CF]
L[公司行为 NDAQ/CA]
M[参考数据 NDAQ/RD]
end
B -.->|Equities 360| G
📚 参考资料
📖 引用
[!TIP] 如果您在研究或工作中使用了这个项目，请使用 CITATION.cff 文件或 APA 格式引用它：
Amorelli, S. (2025). Nasdaq 数据链接 MCP (模型上下文协议) 服务器 [计算机软件]. GitHub. https://github.com/stefanoamorelli/nasdaq-data-link-mcp
📄 许可证
MIT 许可证 © 2025 Stefano Amorelli