MCP Server
Wind MCP Server
A tool server that enables large language models to directly access and utilize WindPy financial data API capabilities, allowing AI to query real-time financial data like a professional analyst.
2
GitHub Stars
8/23/2025
Last Updated
No Configuration
Please check the documentation below.
README Documentation
Wind MCP Server: 让大模型拥有 Wind API能力
本项目是一个实现了 Model Context Protocol (MCP) 标准的工具服务器。
其唯一目标是:将强大的 WindPy 金融数据接口,封装成可被大语言模型 (LLM) 直接调用的标准化工具。
通过本项目,任何安装了 Wind 金融终端的桌面客户端,都可以通过 MCP 的方式,让大模型(如 Cherry Studio, Cursor 内置的 AI)直接理解和操作 Wind API,查询实时金融数据、执行复杂的日期计算,就像一个专业的金融分析师。
可用工具 (Available Tools)
本服务器为大模型提供了以下即插即用的工具,使其能够与 Wind API 交互。
基础工具
工具名称 | 功能描述 |
---|---|
get_today_date(fmt) | 获取服务器当前日期,可指定格式。 |
search_windpy_doc(query) | 在核心 WindPy 函数文档中进行关键词搜索,帮助模型理解API用法。 |
Wind 数据工具
工具名称 | 功能描述 |
---|---|
wind_wsd(...) | (核心)获取日时间序列数据。 用于查询多个标的在一段时间内的历史日线行情、财务等数据。 |
wind_wss(...) | (核心)获取日截面数据。 用于查询多个标的在特定日期的快照数据,如最新价、市盈率等。 |
wind_wses(...) | 获取板块成分股在一段时间内的序列数据。 |
wind_tdays(...) | 获取指定区间内的交易日历。 |
wind_tdaysoffset(...) | 根据一个基准日期,计算向前或向后偏移指定交易日后的日期。 |
wind_tdayscount(...) | 计算一个日期区间内包含的交易日数量。 |
设置与运行
1. 环境准备
确保您的 Windows 机器上已安装 Wind金融终端 并能正常登录。然后,安装 Python 依赖:
pip install -r requirements.txt
2. 启动服务
在项目根目录下,运行以下命令启动 MCP 服务器:
python src/wind_mcp_direct_server.py --host 0.0.0.0 --port 8888
--host 0.0.0.0
允许局域网内的其他设备访问。--port 8888
您可以根据需要修改端口号。
3. 客户端配置
在任何兼容 MCP 标准的客户端(如 Cherry Studio, Cursor 等)中添加如下 JSON 配置,即可开始使用。
{
"mcpServers": {
"wind_mcp": {
"url": "http://localhost:<port>/mcp/",
"transport": "streamable-http"
}
}
}
注意: 请将
<port>
替换为实际运行服务器的 port 地址。
鸣谢 (Acknowledgements)
本项目基于以下优秀的开源项目构建,特此感谢:
- FastMCP: 提供了轻量、高效的 Model Context Protocol 服务器实现。
主要功能
- MCP 标准实现:作为一个标准的 MCP 服务器,可以无缝对接到任何兼容的客户端或框架。
- 简易的管理脚本:提供 Shell 脚本,方便在 macOS上部署和管理 Wind 服务。
- 清晰的项目结构:代码、测试、文档和配置分离,易于理解和维护。
目录结构
项目已经为您重构为更清晰、更标准的结构:
.
├── .gitignore # Git忽略文件配置
├── README.md # 项目主说明文档
├── requirements.txt # Python依赖库
├── config/ # 存放配置文件
│ └── com.wind.mcpserver.plist # (macOS) launchd服务配置示例
├── docs/ # 存放详细的补充文档
│ ├── README_WindPy_MCP.md
│ ├── 调用WindPy.md
│ └── 调用示例.md
├── logs/ # 存放日志文件 (此目录被.gitignore忽略)
├── scripts/ # 存放管理和工具脚本
│ └── manage_wind_service.sh # (macOS) 服务管理脚本
├── src/ # 核心源代码
│ └── wind_mcp_direct_server.py # 核心代理服务程序
└── tests/ # 测试用例
├── test_cn_indicators.py
├── test_date_functions.py
├── test_simple.py
└── test_wind_client.py
本项目采用 MIT 许可证。
Quick Actions
Key Features
Model Context Protocol
Secure Communication
Real-time Updates
Open Source