rvibek/mcp-unhcrpyplot

UNHCR Chart Generation MCP Server

This MCP (Model Context Protocol) server in smithery.ai provides tools for generating UNHCR charts using the FastAPI chart generation service. It allows AI agents to create various types of charts (bar, line, pie, etc.) with UNHCR data visualization.

This server interacts with the UNHCR Chart Generation API.

Features

• Generate various types of charts (bar, line, pie, scatter) with UNHCR data
• Create population trend charts for refugee data
• Generate comparison charts with multiple datasets
• Customize chart titles, labels, and styling
• Return charts as base64-encoded images for easy integration

Connect to MCP Server

To access the server, open your web browser and visit the following URL: https://smithery.ai/server/@rvibek/mcp_unhcrpyplot

Configure the MCP host/client as needed.

API Endpoint

The server generates charts using the following API endpoint:

• https://unhcrpyplot.rvibek.com.np/plot

The API accepts JSON payloads with the following structure:

{
  "chart_type": "string",
  "title": "string",
  "subtitle": "string",
  "x_label": "string",
  "y_label": "string",
  "data": {
    "labels": ["string"],
    "values": [number]
  }
}

MCP Tools

The server exposes the following tools:

generate_unhcr_graph

Generate a UNHCR chart using the FastAPI chart generation service.

Parameters:

• chart_type (required): Type of chart to generate (bar, line, pie, scatter, etc.)
• title (required): Main title of the chart
• subtitle (required): Subtitle describing the chart content
• x_label (required): Label for the x-axis
• y_label (required): Label for the y-axis
• labels (required): List of labels for the data points (e.g., years, countries)
• values (required): List of numerical values corresponding to the labels

Returns:

• Dictionary containing the chart image as base64 and metadata

generate_comparison_chart

Generate a comparison chart with multiple datasets.

Parameters:

• chart_type (required): Type of chart (bar, line, etc.)
• title (required): Main title of the chart
• subtitle (required): Subtitle describing the chart content
• x_label (required): Label for the x-axis
• y_label (required): Label for the y-axis
• datasets (required): List of datasets, each containing 'label', 'labels', and 'values'

Returns:

• Dictionary containing the chart image as base64 and metadata

generate_population_trend_chart

Generate a population trend chart for UNHCR data.

Parameters:

• years (required): List of years for the x-axis
• population_counts (required): List of population counts for each year
• country_name (optional): Name of the country or region being visualized (default: "Country")
• chart_type (optional): Type of chart (line, bar, etc.) (default: "line")

Returns:

• Dictionary containing the chart image as base64 and metadata

Example Usage

Here's an example of how to use the generate_unhcr_graph tool:

# Generate a bar chart showing refugee population trends
result = generate_unhcr_graph(
    chart_type="bar",
    title="Nepali Refugees and Asylum Seekers in Canada (2020-2021)",
    subtitle="UNHCR Population Data",
    x_label="Year",
    y_label="Number of People",
    labels=["2020", "2021"],
    values=[205, 114]
)

Response Format

Successful chart generation returns:

{
  "status": "success",
  "chart_type": "bar",
  "title": "Chart Title",
  "image_base64": "base64_encoded_image_string",
  "image_format": "png",
  "message": "Successfully generated bar chart: Chart Title"
}

License

MIT

Acknowledgments

This project uses the UNHCR Chart Generation API for creating visualizations of UNHCR data.