e-stat-dashboard-mcp 0.1.0

Add your description here

e-Stat Dashboard MCP Server

An MCP (Model Context Protocol) server to interact with the e-Stat Dashboard API, providing Japanese statistical data to LLMs.

Installation

Prerequisites:

• Python 3.10+
• uv (recommended)

uv sync

Running the Server

uv run python -m e_stat_dashboard_mcp.server

Or via MCP Inspector:

npx @modelcontextprotocol/inspector uv run python -m e_stat_dashboard_mcp.server

Tools

search_indicators(keyword: str) -> str

Search for statistical indicators.

• Example: search_indicators(keyword="失業率")
• Returns a Markdown list of matching indicators with codes.

get_stats_data(indicator_code: str, from_date: str = None, to_date: str = None, cycle: str = None) -> str

Get statistical data for a specific indicator.

• Example: get_stats_data(indicator_code="0301010000020020010", from_date="20230100")
• Returns a JSON string of flattened data points.

analyze_stats(data_json: str, analysis_type: str) -> str

Analyze the retrieved data.

• Types:
  • summary: Basic stats (mean, max, min, etc.)
  • cagr (or growth): Compound Annual Growth Rate
  • yoy: Year-Over-Year growth
• Example: analyze_stats(data_json=..., analysis_type="cagr")

generate_graph_code(data_payload: str, graph_type: str, title: str, x_label: str = "Date", y_label: str = "Value") -> str

Generate Python code to visualize data using Matplotlib (with Japanese font support).

• Types: line, bar, scatter
• Example: generate_graph_code(data_payload=..., graph_type="line", title="Unemployment Rate", y_label="Percentage")

list_regions(parent_region_code: str = None) -> str

List regions (Prefectures, etc).

• Example: list_regions(parent_region_code="00000") (Lists prefectures)

Configuration

Environment variables can be set in .env or passed directly. Prefix is ESTAT_.

Variable	Default	Description
ESTAT_API_BASE_URL	https://dashboard.e-stat.go.jp/api/1.0/Json	API Endpoint
ESTAT_LANG	JP	Language

Development

Run tests:

uv run pytest

Run linter:

uv run ruff check .