Wind MCP Server：利用Wind API能力赋能大型模型

该项目是实现Model Context Protocol MCP标准工具服务器。

其唯一目标是使强大的WindPy金融数据接口封装成一个可以直接由大型语言模型（LLMs）调用的标准工具。

通过这个项目，任何已安装Wind金融终端的桌面客户端都可以使用MCP让大型模型（如Cherry Studio、内置到Cursor的AI）直接理解和操作Wind API，查询实时金融数据，并执行复杂的日期计算，就像一个专业的金融分析师一样。

可用工具

该服务器为大型模型提供了以下即插即用工具，用于与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> 替换为实际运行服务器的端口地址。

鸣谢

本项目基于以下优秀的开源项目构建，我们表示感谢：

• 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_m_直接服务.py # 核心代理服务程序
└── tests/              # 测试用例
    ├── test_cn_indicators.py
    ├── test_date_functions.py
    ├── test_simple.py
    └── test_wind_client.py

本项目采用MIT许可。