JUHE API Marketplace
abuttoncc avatar
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