# stockdata-mcp
## 基本信息
- Slug: `xj-bear-stockdata-mcp`
- Source: modelscope
- Publisher: @xj-bear/stockdata-mcp
- Categories: 金融 / search / data-platforms
- Hosted: No
- License: Unknown
- Source URL: https://www.modelscope.cn/mcp/servers/@xj-bear/stockdata-mcp
## 简介
暂无描述。
## 安装提示

```bash
# 安装依赖 pip install mcp akshare pandas starlette uvicorn httpx # 运行 (默认 Stdio 模式) python server.py # 或者使用 MCP Inspector 测试 npx @modelcontextprotocol/inspector python server.py
```

## MCP Server 详情

# 金融数据 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+

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

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

# 或者使用 MCP Inspector 测试
npx @modelcontextprotocol/inspector python server.py
```
如果你安装了 Node.js也可以直接通过 npx 运行需要本地有 Python 环境

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

## Cherry Studio 配置指南

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

### 配置步骤

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

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

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

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

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

## 注意事项

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