# 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](img_fenshi_1day.png)

### 7-Day Multi-Day Chart

![7-Day Chart](img_fenshi_7day.png)

## Installation

### Prerequisites

- Python 3.10+
- Linux system (for systemd service)

### Quick Install

```bash
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:

```json
{
  "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:**
```json
{
  "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:**
```json
{
  "tool": "generate_multi_day_chart",
  "arguments": {
    "code": "000001",
    "start_date": "20240513",
    "end_date": "20240517"
  }
}
```

### HTTP Mode (Standalone)

Run as HTTP service:

```bash
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:

```bash
# 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
```

## Dependencies

- `mcp>=1.20.0`: MCP SDK
- `mootdx>=0.11.0`: Market data source
- `matplotlib>=3.8.0`: Chart rendering
- `pandas>=2.0.0`: Data processing
- `numpy>=1.24.0`: Numerical operations

## License

MIT