MCP Stock Assistant

# MCP Stock Assistant 一个基于模型上下文协议 (MCP) 的股票信息服务器，使用东方财富API提供实时股票数据。 ## 功能特性 - 📈 获取实时股票数据（支持股票代码或名称查询） - 📊 获取股票历史K线数据（日K、周K、月K） - 🏛️ 获取大盘指数信息（上证指数、深证成指） - 💹 详细的买卖盘口信息 - 📋 支持中国A股市场（沪深两市） - 🔍 智能股票搜索（支持股票名称模糊匹配） ## 安装说明 1. 克隆仓库： ```bash git clone <repository-url> cd mcp-stock ``` 2. 安装依赖： ```bash pnpm install ``` 3. 构建项目： ```bash pnpm run build ``` ## 使用方法 ### 配置MCP客户端 在Claude Desktop或其他MCP客户端的配置文件中添加以下配置： ```json { "mcpServers": { "mcp-stock": { "command": "node", "args": [ "/Users/zhangyanhua/Documents/augment-projects/mcp-stock/build/index.js" // 打包后的真实路径 ] } } } ``` 该服务器实现了模型上下文协议，可以与任何支持MCP的客户端配合使用，如Claude Desktop。 ### 可用工具 服务器提供以下三个工具： 1. **`get-stock-info`**: 获取股票实时信息 - 参数: `stock_code` - 股票代码或名称（例如：600519 或 贵州茅台） 2. **`get-stock-history`**: 获取股票历史数据 - 参数: - `stock_code` - 股票代码或名称 - `period` - 时间周期（1d=日K线, 1w=周K线, 1m=月K线，默认1d） - `days` - 获取天数（1-500天，默认30天） 3. **`get-market-index`**: 获取大盘指数信息 - 无参数，返回上证指数和深证成指的实时数据 ### 使用示例 #### 1. 获取股票实时信息 ``` 股票信息: 600519 (贵州茅台) 当前价格: 1756.00 跌幅: -0.85% 涨跌额: -15.00 开盘价: 1770.00 最高价: 1775.00 最低价: 1750.00 昨收价: 1771.00 成交量: 45678.00手 成交额: 8023456.00万 换手率: 0.36% 市盈率(动态): 35.2 振幅: 1.41% 更新时间: 15:00:00 买卖盘口: 卖5: 1758.00 / 120.00手 卖4: 1757.00 / 89.00手 卖3: 1756.50 / 156.00手 卖2: 1756.20 / 234.00手 卖1: 1756.00 / 67.00手 买1: 1755.80 / 145.00手 买2: 1755.50 / 78.00手 买3: 1755.20 / 203.00手 买4: 1755.00 / 167.00手 买5: 1754.80 / 89.00手 ``` #### 2. 获取股票历史数据 ``` 📈 贵州茅台(600519) 历史数据 (最近10个交易日) 日期 开盘 收盘 最高 最低 成交量(手) 涨跌幅 ───────────────────────────────────────────────────────────────── 2024-01-15 1770.00 1756.00 1775.00 1750.00 45678.00 📉-0.85% 2024-01-12 1780.00 1771.00 1785.00 1765.00 52341.00 📈+0.57% ... 📊 统计信息: 最高价: 1785.00 最低价: 1720.00 平均价: 1752.50 总成交量: 456789.00手 ``` #### 3. 获取大盘指数信息 ``` 📊 大盘指数信息 指数名称 当前点位 涨跌幅 涨跌点 成交量(手) 成交额(万) ────────────────────────────────────────────────────────────────── 上证指数 2956.48 📉-0.42% -12.56 123456789.00 45678901.00 深证成指 9234.67 📉-0.38% -35.23 98765432.00 32109876.00 🕐 更新时间: 15:00:00 ``` ## 股票代码格式 支持以下格式的股票查询： ### 按代码查询 - **沪市A股**: 6位数字代码（如：`600519`、`601318`、`688981`） - **深市A股**: 6位数字代码（如：`000858`、`002415`、`300750`） ### 按名称查询 - **股票全名**: 如 `贵州茅台`、`平安银行` - **股票简称**: 如 `茅台`、`平安` ### 代码规则 - **沪市主板**: 600、601、603、605开头 - **科创板**: 688开头 - **深市主板**: 000开头 - **中小板**: 002开头 - **创业板**: 300、301开头 ## 技术说明 - 📡 使用东方财富API获取实时股票数据 - 🔌 基于stdio传输协议，与MCP客户端完全兼容 - 🆓 无需API密钥，免费使用（可能存在频率限制） - 🚀 支持智能搜索，可通过股票名称模糊匹配 - 📊 提供完整的技术指标和盘口数据 ## 开源协议 ISC