BPS MCP Server

MCP (Model Context Protocol) server untuk data statistik BPS (Badan Pusat Statistik) Indonesia. Memungkinkan AI clients seperti Claude Desktop, Claude Code, Cursor, dan lainnya untuk mengakses data statistik resmi Indonesia melalui natural language.

Fitur

• 32 tools mencakup seluruh endpoint BPS API v1
• 3 MCP Resources — domain list, kabupaten per provinsi, subjek per domain
• 5 MCP Prompts — template analisis data siap pakai
• Domain resolver dengan fuzzy matching (ketik "Jatim" → Jawa Timur)
• Data formatter yang mengubah raw BPS data menjadi format mudah dibaca
• In-memory cache dengan TTL per tipe data
• Bilingual — mendukung bahasa Indonesia dan Inggris
• Atribusi BPS otomatis di setiap response (sesuai ToU)
• BYOK (Bring Your Own Key) — setiap user menggunakan API key BPS sendiri

Prasyarat

• Node.js ≥ 18
• API key BPS (gratis, daftar di webapi.bps.go.id)

Instalasi & Penggunaan

Via npx (recommended)

BPS_API_KEY=your_key npx bps-mcp-server

Clone & Run

git clone https://github.com/murphi/bps-mcp-server
cd bps-mcp-server
npm install
npm run build
BPS_API_KEY=your_key npm start

Akses Remote via Cloudflare Workers

Server ini tersedia secara publik di:

https://bps-mcp-server.murphi.my.id/mcp

Tambahkan ke MCP client manapun (Claude Desktop, Cursor, dll.) via remote transport:

{
  "mcpServers": {
    "bps-statistics": {
      "type": "http",
      "url": "https://bps-mcp-server.murphi.my.id/mcp",
      "headers": {
        "X-BPS-API-Key": "your_api_key_here"
      }
    }
  }
}

Self-hosted

Ingin deploy sendiri? Deploy sebagai serverless worker di akun Cloudflare kamu:

Lihat panduan lengkap di docs/DEPLOY-WORKERS.md.

Konfigurasi MCP Client

Claude Desktop

File: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

{
  "mcpServers": {
    "bps-statistics": {
      "command": "npx",
      "args": ["-y", "bps-mcp-server"],
      "env": {
        "BPS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code

claude mcp add bps -- npx -y bps-mcp-server

Atau file .mcp.json di project root:

{
  "mcpServers": {
    "bps": {
      "command": "npx",
      "args": ["-y", "bps-mcp-server"],
      "env": {
        "BPS_API_KEY": "${BPS_API_KEY}"
      }
    }
  }
}

Cursor / VS Code

File ~/.cursor/mcp.json atau .vscode/mcp.json:

{
  "mcpServers": {
    "bps-statistics": {
      "command": "npx",
      "args": ["-y", "bps-mcp-server"],
      "env": {
        "BPS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Tools (32)

Resources (3)

Prompts (5)

Contoh Query

"Berapa jumlah penduduk Indonesia tahun 2023?"
"Bandingkan angka kemiskinan Jawa Timur vs Jawa Barat 2020-2023"
"Cari BRS terbaru tentang inflasi"
"Data ekspor kopi Indonesia tahun 2024"

Environment Variables

Development

git clone https://github.com/murphi/bps-mcp-server
cd bps-mcp-server
npm install
npm run build
npm run test:unit

Atribusi

Sumber: Badan Pusat Statistik (BPS) — https://www.bps.go.id Layanan ini menggunakan API Badan Pusat Statistik (BPS).

Lisensi

MIT