Charts Visualization
This project provides a web-based service for generating and visualizing bar and pie charts from structured data using FastAPI and Altair. Charts are generated as PNG images and served via a REST API.
Features
- Generate bar and pie charts from input data
- Save charts as PNG images in a static directory
- Access generated charts via unique URLs
- Extensible with new chart types
Project Structure
charts_visualization/
├── requirements.txt # Python dependencies
├── README.md # Project documentation
├── src/
│ ├── server.py # FastAPI server and MCP integration
│ ├── client.py # Example client for interacting with the server
│ ├── charts/
│ │ ├── bar_chart.py # Bar chart generation logic
│ │ ├── pie_chart.py # Pie chart generation logic
│ │ └── __init__.py
│ └── model/
│ └── main.py # Data models and shared logic
├── static/
│ └── charts/ # Generated chart images (PNG)
Setup
- Clone the repository:
git clone <repo-url> cd charts_visualization - Create a virtual environment and install dependencies:
python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt
Running the Server
Start the FastAPI server (from the project root):
python src/server.py
Or with Uvicorn:
uvicorn src.server:app --host 0.0.0.0 --port 8000
uv run python server.py
for inspection :
uv run mcp dev server.py
Usage
- Use the provided client (
src/client.py) or send requests to the/mcpendpoint to generate charts. - Generated charts are saved in
static/charts/and accessible via URLs likehttp://localhost:8000/static/charts/<chart_id>.png.
Requirements
- Python 3.9+
- FastAPI
- Uvicorn
- Altair
- (See
requirements.txtfor full list)
Extending
To add new chart types, implement a new function in src/charts/, register it as an MCP tool in src/server.py, and update the client as needed.
License
MIT License