e-stat-dashboard-mcp 0.1.1

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 & Usage

Using uv (Recommended)

You can run the server directly without installing it using uvx:

uvx e-stat-dashboard-mcp

via Claude Desktop config

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "e-stat-dashboard": {
      "command": "uvx",
      "args": ["e-stat-dashboard-mcp"]
    }
  }
}

Manual Installation (pip)

pip install e-stat-dashboard-mcp
python -m e_stat_dashboard_mcp.server

Local Development

Clone the repository and install dependencies:

git clone https://github.com/takurot/e-stat-dashboard-mcp.git
cd e-stat-dashboard-mcp
uv sync

Running the Server (Local)

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 .