Stock Mcp Service

Name: Stock Mcp Service
Author: BigBossWHD

@BigBossWHD

Repository

About Stock Mcp Service

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "stock-market": {
      "command": "uv",
      "args": [
        "--directory",
        "PATH_TO_PROJECT",
        "run",
        "stock_mcp_server.py"
      ],
      "transportType": "stdio"
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Stock Mcp Service?

Stock Mcp Service is an MCP (Model Context Protocol) server that provides comprehensive Chinese A-share stock market data, including real-time prices, historical K-line data, market indices, technical analysis indicators, and time services. It is built for AI assistants and developers who need to query stock information through MCP-compatible clients.

How to use Stock Mcp Service?

Install dependencies with uv (curl -LsSf https://astral.sh/uv/install.sh | sh then uv sync --no-install-project). Configure your MCP client with the command uv --directory PATH_TO_YOUR_STOCK_MCP_SERVICE/stock_mcp_service run stock_mcp_server.py and transport type stdio. For debugging, start the server manually with uv run python stock_mcp_server.py.

Key features of Stock Mcp Service

Real-time A-share stock prices, change percentages, and volume
Historical K-line data (daily, weekly, monthly)
Major market indices (SSE, SZSE, ChiNext, STAR 50, CSI 300, CSI 500)
Technical indicators: MA, MACD, RSI, KDJ, Bollinger Bands
Automatic technical state analysis (bull/bear, golden/death cross)
Data caching, mixed data sources, and error handling

Use cases of Stock Mcp Service

Retrieve current stock prices and trading status during market hours
Analyze stock trends with historical data and technical indicators
Generate comprehensive stock analysis reports for investment research
Check market indices and search stocks by name or code

FAQ from Stock Mcp Service

Why does real-time data show 0?

This may happen outside of trading hours. The system automatically marks the data status to indicate whether it was obtained during trading time.

Why do Shenzhen Component Index and ChiNext Index use different data sources?

This is normal. The system uses a mixed data source strategy to ensure data completeness, switching intelligently between sources.

Why do technical indicator results differ from other software?

Differences may arise from calculation periods or algorithms. This system uses standard financial algorithms.

What are the runtime requirements?

Python and the uv package manager are required. A stable internet connection is needed to access data sources (East Money, Sina Finance, Tencent Finance, etc.).