stock-mcp

very99/stock-mcp

3.3

If you are the rightful owner of stock-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A comprehensive MCP server for Chinese A-share stock data collection and analysis, enhanced with multi-source data verification and professional financial analysis.

Stock MCP Server - Enhanced

English | 中文


English

A comprehensive MCP (Model Context Protocol) server for Chinese A-share stock data collection and analysis. Enhanced with multi-source data verification and professional financial analysis.

✨ Enhanced Features

  • 📊 Multi-Source Real-time Data: Cross-verified data from Sina, Tencent, and Eastmoney APIs
  • 📈 Professional Technical Analysis: MA5/10/20/60, RSI, MACD, Volume Ratio, Turnover Rate
  • 📋 Historical Data Analysis: 60+ days of historical data with trend and volatility analysis
  • 📰 Real News Collection: Multi-source news aggregation with sentiment analysis
  • 🔍 Comprehensive Analysis: All-in-one stock analysis combining multiple data sources
  • 🌐 Data Quality Assurance: Multi-source verification with automatic fallback

🚀 Quick Start

  1. Clone the repository

    git clone https://github.com/very99/stock-mcp.git
    cd stock-mcp
    
  2. Install dependencies

    npm install
    
  3. Build the project

    npm run build
    
  4. Configure your MCP client

    For Amazon Q CLI (~/.aws/amazonq/mcp.json):

    {
      "mcpServers": {
        "stock": {
          "command": "node",
          "args": ["/path/to/stock-mcp/dist/index.js"],
          "timeout": 30000
        }
      }
    }
    

🛠️ Available Tools

get_stock_data

Get real-time stock quotes with multi-source verification

Parameters:
- symbol: Stock code (e.g., "600519", "000858")
- include_technical: Include technical indicators (default: true)

Returns: Real-time price, technical indicators, data source verification
get_historical_data ⭐ NEW

Get historical data with professional trend analysis

Parameters:
- symbol: Stock code
- days: Historical data days (default: 60)
- include_analysis: Include trend analysis (default: true)

Returns: Historical prices, trend analysis, volatility assessment, risk level
get_stock_news

Collect real stock news with sentiment analysis

Parameters:
- symbol: Stock code
- stock_name: Stock name for news search

Returns: Latest news, sentiment analysis, source verification
get_market_overview

Get market overview with major indices

Parameters:
- include_money_flow: Include capital flow data (default: true)

Returns: Major indices, market sentiment, money flow analysis
comprehensive_analysis

Complete stock analysis with all data sources

Parameters:
- symbol: Stock code
- stock_name: Stock name

Returns: Real-time + technical + news + market environment analysis

📖 Usage Examples

# Multi-source verified real-time data
User: "Get stock data for 600519"
AI: Returns price from 3 verified sources + professional technical indicators

# Historical trend analysis
User: "Get 60-day historical data for 600519 with analysis"
AI: Returns trend analysis, volatility assessment, risk level evaluation

# Comprehensive investment analysis
User: "Comprehensive analysis of Kweichow Moutai"
AI: Returns complete analysis combining all data sources for investment decision

🔧 Enhanced Data Sources

  • Sina Finance API: Primary real-time and historical data (GBK encoding handled)
  • Tencent Finance API: Secondary verification source
  • Eastmoney API: Enhanced data with additional metrics
  • Multi-source News: Aggregated financial news with sentiment analysis

🌟 Key Enhancements

  • 🚀 Multi-Source Verification: Cross-validates data from 3+ sources
  • 📊 Professional Analysis: Volatility, trend analysis, risk assessment
  • 🔄 Real Historical Data: 60+ days of actual trading data
  • 🧠 AI-Ready Output: Structured data perfect for AI investment analysis
  • 🇨🇳 China Market Focus: Specialized for A-share market with proper encoding

📊 Technical Indicators

  • Moving Averages: MA5, MA10, MA20, MA60
  • Momentum: RSI (14-period) with overbought/oversold signals
  • MACD: DIF, DEA, MACD histogram
  • Volume: Volume ratio and turnover rate
  • Risk Metrics: Annualized volatility and risk level assessment

中文

一个用于中国A股数据收集和分析的综合性 MCP 服务器。增强版具备多源数据验证和专业金融分析功能。

✨ 增强功能

  • 📊 多源实时数据: 新浪、腾讯、东方财富API交叉验证
  • 📈 专业技术分析: MA5/10/20/60、RSI、MACD、量比、换手率
  • 📋 历史数据分析: 60+天历史数据,趋势和波动率分析
  • 📰 真实新闻收集: 多源新闻聚合,情绪分析
  • 🔍 综合分析: 整合多数据源的一站式股票分析
  • 🌐 数据质量保证: 多源验证,自动切换备用源

🚀 快速开始

  1. 克隆仓库

    git clone https://github.com/very99/stock-mcp.git
    cd stock-mcp
    
  2. 安装依赖

    npm install
    
  3. 构建项目

    npm run build
    

🛠️ 可用工具

get_stock_data

获取多源验证的实时股票数据

参数:
- symbol: 股票代码 (如 "600519", "000858")
- include_technical: 是否包含技术指标 (默认: true)

返回: 实时价格、技术指标、数据源验证信息
get_historical_data ⭐ 新功能

获取历史数据和专业趋势分析

参数:
- symbol: 股票代码
- days: 历史数据天数 (默认: 60天)
- include_analysis: 是否包含趋势分析 (默认: true)

返回: 历史价格、趋势分析、波动率评估、风险等级
comprehensive_analysis

综合分析,整合所有数据源

参数:
- symbol: 股票代码
- stock_name: 股票名称

返回: 实时+技术+新闻+市场环境的完整分析

📖 使用示例

# 多源验证的实时数据
用户: "获取600519的股票数据"
AI: 返回3个数据源验证的价格 + 专业技术指标

# 历史趋势分析
用户: "获取600519的60天历史数据和分析"
AI: 返回趋势分析、波动率评估、风险等级评价

# 综合投资分析
用户: "全面分析贵州茅台"
AI: 返回整合所有数据源的完整投资分析

🔧 增强数据源

  • 新浪财经API: 主要实时和历史数据源(已处理GBK编码)
  • 腾讯财经API: 二级验证数据源
  • 东方财富API: 增强数据,提供额外指标
  • 多源新闻: 聚合财经新闻,情绪分析

🌟 核心增强

  • 🚀 多源验证: 3+数据源交叉验证
  • 📊 专业分析: 波动率、趋势分析、风险评估
  • 🔄 真实历史数据: 60+天实际交易数据
  • 🧠 AI友好输出: 完美适配AI投资分析的结构化数据
  • 🇨🇳 A股专业: 专门针对A股市场,正确处理中文编码

⚠️ 免责声明

本工具仅供学习和研究使用,所提供的数据和分析结果仅供参考,不构成投资建议。投资有风险,决策需谨慎。


Contributing

We welcome contributions! Please see for guidelines.

License

MIT License - see file for details.