UNHCR Chart Generation

You can generate UNHCR charts by connecting to a dedicated MCP server and using its chart tools. This server exposes several chart generation capabilities through a standardized interface, returning images in a base64 format for easy embedding in dashboards and reports.

How to use

To use this MCP server, connect with your MCP client to the provided MCP URL and call the available chart tools. You can generate single charts like bar, line, pie, or scatter, create population trend charts, and produce comparison charts across multiple datasets. Each tool returns a chart image encoded in base64 along with metadata to help you integrate the visualization into your application.

How to install

Prerequisites: ensure you have a modern runtime environment installed, such as Node.js and npm.

# 1) Clone the MCP server repository
git clone https://github.com/rvibek/mcp-unhcrpyplot.git
cd mcp-unhcrpyplot

# 2) Install dependencies
npm install

# 3) Start the MCP server
npm run start

Configuration and usage notes

This MCP server exposes HTTP endpoints for chart generation. The primary remote API endpoint used by the server is the UNHCR Chart Generation API, which you can leverage from within your applications via the MCP tools. When you initialize your MCP client, point it at the MCP URL and use the available tools to generate charts. If you need to customize chart styling, titles, labels, or multiple datasets, supply the corresponding parameters through the tool calls.

Security and maintenance notes

Ensure your MCP client and any connected applications enforce appropriate authentication and authorization before invoking chart generation. Keep dependencies up to date and monitor usage to prevent abuse of chart generation resources. If you rotate API keys or credentials, update them in your environment and restart the MCP server as needed.

Available tools

generate_unhcr_graph

Generate a UNHCR chart using the FastAPI chart generation service. Accepts chart_type, title, subtitle, x_label, y_label, labels, and values and returns a chart image in base64 along with metadata.

generate_comparison_chart

Create a chart that compares multiple datasets. Requires chart_type, title, subtitle, x_label, y_label, and datasets (each with label, labels, and values). Returns a base64 image and metadata.

generate_population_trend_chart

Produce a population trend visualization for UNHCR data. Supports years, population_counts, with optional country_name and chart_type defaulting to line.