stockdata-mcp

@xj-bear/stockdata-mcp

0 Stars 182 次浏览 xj-bear 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "stockdata": {
      "args": [
        "g:your-disk-pathstockdataserver.py"
      ],
      "command": "python",
      "env": {
        "MCP_MODE": "stdio"
      }
    }
  }
}

服务介绍

金融数据 MCP 服务器 (Stock Data MCP Server)

这是一个基于 Model Context Protocol (MCP) 的金融数据查询服务器支持股票指数基金和期货的历史数据查询

功能特性

功能模块
- 个股深度
  - **信息 (Info)**获取个股详细信息
  - **指标 (Indicators)**获取关键财务指标A股/港股/美股
  - **建议 (Suggest)**基于技术指标MA, RSI的简单投资建议
- 市场概况
  - 涨停/龙虎榜获取每日涨停股池及龙虎榜数据
  - 资金流向行业板块资金流向排名
- 财经资讯
  - 个股新闻获取特定股票的新闻
  - 全球快讯获取全球财经快讯财联社
- 数据查询
  - **股票 (Stock)**支持 A 股港股美股的历史数据查询支持模糊搜索
  - **指数 (Index)**支持常见指数如 "上证指数"
  - **基金 (Fund)**支持 ETF 和部分基金查询
  - **期货 (Futures)**支持国内及外盘期货数据
数据源
- 首选东方财富 (Eastmoney) - 数据最全但对云环境 IP 限制严格
- 备用新浪财经 (Sina) - 当首选接口连接失败时自动切换确保服务高可用
双模式运行
- Stdio 模式适用于本地 CLI 或 MCP Inspector
- SSE 模式适用于 Docker 部署或远程调用

可用工具 (Available Tools)

get_current_time: 获取系统时间
get_stock_info: 获取个股基本信息 (支持 A/港/美股)
get_stock_indicators: 获取个股财务指标 (PE/PB/ROE等)
get_financial_report: 获取个股详细财务报表摘要
get_trading_suggest: 获取个股简单交易建议
get_stock_zt_pool: 获取涨停股池
get_stock_lhb: 获取龙虎榜数据
get_sector_fund_flow: 获取行业资金流向
get_stock_news: 获取个股新闻
get_global_news: 获取全球财经快讯
query_stock_data: 查询 A 股历史数据 (名称/代码)
query_index_data: 查询 A 股指数历史数据
query_fund_data: 查询 A 股基金/ETF 历史数据
query_futures_data: 查询国内期货历史数据
query_us_stock_data: 查询美股历史数据 (名称/代码)
query_us_fund_data: 查询美股基金/ETF 历史数据
query_foreign_futures_data: 查询外盘期货历史数据
get_hk_stock_data: 查询港股历史数据

安装与使用

1. 本地运行 (Python)

确保已安装 Python 3.10+

# 安装依赖
pip install mcp akshare pandas starlette uvicorn httpx

# 运行 (默认 Stdio 模式)
python server.py

# 或者使用 MCP Inspector 测试
npx @modelcontextprotocol/inspector python server.py

如果你安装了 Node.js也可以直接通过 npx 运行需要本地有 Python 环境

# 在项目根目录下
npm install
npx stockdata-mcp

Cherry Studio 配置指南

本服务器完全支持 Stdio 模式可以直接在 Cherry Studio 中配置使用

配置步骤

打开 Cherry Studio
进入 设置 (Settings) -> MCP 服务器 (MCP Servers)
点击 添加 (Add)
填写以下信息
- 名称 (Name): Stock Data MCP (或任意名称)
- 类型 (Type): Stdio
- 命令 (Command): python (确保 python 在系统 PATH 中或者使用绝对路径)
- 参数 (Args):
  - g:\path\to\stockdata\server.py (请使用 server.py 的绝对路径)
点击 保存 (Save)
启用该服务器Cherry Studio 应显示 "Connected" (已连接)

常见问题

如果连接失败请检查 python 是否能成功运行 import akshare
确保 Cherry Studio 有权限访问该目录

配置文件示例 (Claude Desktop / Cherry Studio)

你可以将以下配置添加到你的 MCP 客户端配置文件中 (如 claude_desktop_config.json)

{
  "mcpServers": {
    "stockdata": {
      "command": "python",
      "args": [
        "g:\\your-disk-path\\stockdata\\server.py"
      ],
      "env": {
        "MCP_MODE": "stdio"
      }
    }
  }
}

注意事项

数据来源于 akshare请确保网络通畅以便连接相关数据接口
模糊搜索可能需要一定时间下载列表首次运行可能会稍慢

查看源码项目主页