MCP 股票助手

基于模型上下文协议（MCP）的股票信息服务，使用东方财富API提供实时股票数据。

特性

• 📈 获取实时股票数据（支持股票代码或名称查询）
• 📊 获取股票的历史K线数据（日K、周K、月K）
• 🏛️ 获取主要市场指数信息（上证综合指数、深证成分指数）
• 💹 详细的买卖信息
• 📋 支持中国A股市场（上海和深圳股市）
• 🔍 智能股票搜索（支持股票名称模糊匹配）

安装指南

1. 克隆仓库：

   git clone <repository-url>
   cd mcp-stock
   

2. 安装依赖：

   pnpm install
   

3. 构建项目：

   pnpm run build
   

使用说明

配置MCP客户端

在Claude Desktop或其他MCP客户端的配置文件中添加以下配置：

{
  "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