MCP Satu Data Ngawi

MCP (Model Context Protocol) Server untuk mengakses data dari Portal Satu Data Kabupaten Ngawi.

🌐 Portal Sumber Data

• Website: https://satudata.ngawikab.go.id
• API Base: https://apidata.kabngawi.id/api/guest

📦 Instalasi

1. Clone/Download Repository

git clone <repository-url>
cd mcp-satudata-ngawi

2. Install Dependencies

npm install

3. Build Project

npm run build

🔧 Konfigurasi untuk Claude Desktop

Tambahkan konfigurasi berikut ke file claude_desktop_config.json:

Windows

Lokasi: %APPDATA%\Claude\claude_desktop_config.json

macOS

Lokasi: ~/Library/Application Support/Claude/claude_desktop_config.json

Linux

Lokasi: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "satudata-ngawi": {
      "command": "node",
      "args": ["/path/to/mcp-satudata-ngawi/dist/index.js"]
    }
  }
}

Atau jika menggunakan npx:

{
  "mcpServers": {
    "satudata-ngawi": {
      "command": "npx",
      "args": ["-y", "/path/to/mcp-satudata-ngawi"]
    }
  }
}

🛠️ Tools yang Tersedia

1. get_kategori_sektoral

Mendapatkan daftar kategori sektoral/sektor data.

Parameters:

• page (number, optional): Nomor halaman (default: 1)
• per_page (number, optional): Jumlah data per halaman (default: 100)

Contoh Penggunaan:

Tampilkan semua kategori data di Satu Data Ngawi

2. get_organisasi

Mendapatkan daftar organisasi/OPD (Organisasi Perangkat Daerah).

Parameters:

• page (number, optional): Nomor halaman
• per_page (number, optional): Jumlah data per halaman
• q (string, optional): Kata kunci pencarian

Contoh Penggunaan:

Cari organisasi dengan nama "Dinas Kesehatan" di Ngawi

3. get_data_sektoral

Mendapatkan daftar data sektoral/dataset.

Parameters:

• page (number, optional): Nomor halaman
• per_page (number, optional): Jumlah data per halaman
• q (string, optional): Kata kunci pencarian
• kategori_id (number, optional): Filter berdasarkan ID kategori
• organisasi_id (number, optional): Filter berdasarkan ID organisasi

Contoh Penggunaan:

Tampilkan data sektoral tentang pertanian di Ngawi

4. get_detail_data

Mendapatkan detail lengkap dari sebuah data sektoral.

Parameters:

• id (number, required): ID data sektoral

Contoh Penggunaan:

Lihat detail data dengan ID 123

5. search_data

Mencari data berdasarkan kata kunci.

Parameters:

• keyword (string, required): Kata kunci pencarian
• limit (number, optional): Jumlah hasil maksimal (default: 10)

Contoh Penggunaan:

Cari data tentang "kemiskinan" di Satu Data Ngawi

6. get_statistics

Mendapatkan ringkasan statistik portal.

Parameters: Tidak ada

Contoh Penggunaan:

Berapa total dataset yang ada di Satu Data Ngawi?

📚 Resources

satudata://kategori

Daftar lengkap kategori sektoral dalam format JSON.

🔍 Contoh Percakapan dengan Claude

User: Apa saja kategori data yang tersedia di Satu Data Ngawi?

Claude: [Menggunakan get_kategori_sektoral]
Berikut kategori data yang tersedia:
1. Pertanian
2. Peternakan
3. Pendidikan
4. Kesehatan
... dst

User: Cari data tentang kesehatan

Claude: [Menggunakan search_data dengan keyword "kesehatan"]
Ditemukan beberapa dataset tentang kesehatan:
1. Jumlah Puskesmas per Kecamatan
2. Data Imunisasi Anak
... dst

User: Lihat detail data nomor 1

Claude: [Menggunakan get_detail_data dengan ID yang sesuai]
Detail Data:
- Judul: Jumlah Puskesmas per Kecamatan
- Tahun: 2023
- Sumber: Dinas Kesehatan
... dst

🏗️ Struktur Project

mcp-satudata-ngawi/
├── src/
│   └── index.ts        # Source code utama
├── dist/
│   └── index.js        # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

📝 API Endpoints yang Digunakan

Endpoint	Deskripsi
/kategori-sektoral	Daftar kategori/sektor data
/organisasi	Daftar OPD/instansi
/data-sektoral	Daftar dataset
/data-sektoral/{id}	Detail dataset

🤝 Kontribusi

Silakan buat issue atau pull request jika menemukan bug atau ingin menambahkan fitur.

📄 Lisensi

MIT License

🙏 Credits

• Portal Satu Data Kabupaten Ngawi
• Anthropic MCP SDK