MCP 服务器

Fenshitu MCP

Generates professional A-share intraday stock charts with 1-day and multi-day views, matching Chinese trading software styles.

README

Fenshitu MCP

A-share stock intraday chart generation MCP (Model Context Protocol) service. Generates professional stock charts matching Chinese trading software styles (East Money, Tonghuashun).

Features

1-Day Intraday Chart: Complete trading day chart with price line, VWAP, volume bars
Multi-Day Chart: Up to 7 consecutive trading days with unified price scale
Professional Styling: Dark theme, dual Y-axis (price + percentage), red/green volume bars
Trading Hours: Correctly handles A-share trading hours (09:30-11:30, 13:00-15:00) with proper gap at lunch break
Data Source: mootdx (TongdaXin market data)
System Service: systemd support with auto-start

Screenshots

1-Day Intraday Chart

1-Day Chart

7-Day Multi-Day Chart

7-Day Chart

Installation

Prerequisites

Python 3.10+
Linux system (for systemd service)

Quick Install

git clone https://github.com/hopkdj/fenshitu-mcp.git
cd fenshitu-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Usage

MCP Integration

Add to your MCP client configuration:

{
  "mcpServers": {
    "fenshitu-mcp": {
      "command": "/path/to/fenshitu-mcp/.venv/bin/python",
      "args": ["-m", "fenshitu.server"],
      "cwd": "/path/to/fenshitu-mcp"
    }
  }
}

Available Tools

`generate_intraday_chart`

Generate a 1-day intraday chart.

Parameters:

code (required): Stock code, e.g., "000001", "600379"
date (optional): Trading date in YYYYMMDD format, defaults to today
output_path (optional): Output file path

Example:

{
  "tool": "generate_intraday_chart",
  "arguments": {
    "code": "000001",
    "date": "20240515"
  }
}

`generate_multi_day_chart`

Generate a multi-day intraday chart (up to 7 days).

Parameters:

code (required): Stock code
start_date (required): Start date in YYYYMMDD format
end_date (optional): End date in YYYYMMDD format, defaults to start_date
output_path (optional): Output file path

Example:

{
  "tool": "generate_multi_day_chart",
  "arguments": {
    "code": "000001",
    "start_date": "20240513",
    "end_date": "20240517"
  }
}

HTTP Mode (Standalone)

Run as HTTP service:

export MCP_TRANSPORT=http
export MCP_HOST=0.0.0.0
export MCP_PORT=8090
python -m fenshitu.server

Systemd Service

The service is configured for auto-start:

# Enable and start
sudo systemctl enable fenshitu-mcp.service
sudo systemctl start fenshitu-mcp.service

# Check status
systemctl status fenshitu-mcp.service

# View logs
journalctl -u fenshitu-mcp.service -f

Chart Features

1-Day Chart

White price line + Yellow VWAP line
Red/Green volume bars (A-share convention: red=up, green=down)
Dual Y-axis: Left (price), Right (percentage change)
Time labels: 09:30, 10:30, 11:30, 13:00, 14:00, 15:00
Title with stock name, code, date, and weekday
Info bar: close price, change %, high, low, volume

Multi-Day Chart

5 trading days displayed horizontally
Unified price scale across all days
Daily price chart + volume chart
Time labels per day: 09:30, 11:30, 13:00, 15:00
Proper gap at lunch break (11:30-13:00)

Project Structure

fenshitu-mcp/
├── src/fenshitu/
│   ├── server.py           # MCP server entry point
│   ├── data_fetcher.py     # Data fetching (mootdx)
│   ├── chart_1day.py       # 1-day chart generator
│   ├── chart_7day.py       # Multi-day chart generator
│   ├── indicators.py       # Technical indicators (VWAP)
│   └── styles.py           # Style constants
├── pyproject.toml
├── requirements.txt
├── MCP_INTEGRATION.md      # Detailed integration guide
└── README.md