mcp-satudata-ngawi 1.0.0

package/README.md

@@ -0,0 +1,212 @@
+# 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
+
+```bash
+git clone <repository-url>
+cd mcp-satudata-ngawi
+```
+
+### 2. Install Dependencies
+
+```bash
+npm install
+```
+
+### 3. Build Project
+
+```bash
+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`
+
+```json
+{
+  "mcpServers": {
+    "satudata-ngawi": {
+      "command": "node",
+      "args": ["/path/to/mcp-satudata-ngawi/dist/index.js"]
+    }
+  }
+}
+```
+
+Atau jika menggunakan `npx`:
+
+```json
+{
+  "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

package/claude_desktop_config.example.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "satudata-ngawi": {
+      "command": "node",
+      "args": ["/GANTI/DENGAN/PATH/ANDA/mcp-satudata-ngawi/dist/index.js"]
+    }
+  }
+}

package/dist/CLAUDE.md

@@ -0,0 +1,7 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+*No recent activity*
+</claude-mem-context>

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,315 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+// Base URL untuk API Satu Data Ngawi
+const BASE_URL = "https://apidata.kabngawi.id/api/guest";
+// Helper function untuk fetch API
+async function fetchAPI(endpoint, params) {
+    const url = new URL(`${BASE_URL}${endpoint}`);
+    if (params) {
+        Object.entries(params).forEach(([key, value]) => {
+            url.searchParams.append(key, String(value));
+        });
+    }
+    const response = await fetch(url.toString(), {
+        headers: {
+            "Accept": "application/json",
+            "Content-Type": "application/json",
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`API Error: ${response.status} ${response.statusText}`);
+    }
+    return response.json();
+}
+// Create MCP Server
+const server = new McpServer({
+    name: "satudata-ngawi",
+    version: "1.0.0",
+});
+// Tool: Get Kategori Sektoral (Daftar Sektor/Kategori Data)
+server.tool("get_kategori_sektoral", "Mendapatkan daftar kategori sektoral/sektor data yang tersedia di Satu Data Ngawi. Contoh: Pertanian, Kesehatan, Pendidikan, dll.", {
+    page: z.number().optional().default(1).describe("Nomor halaman (default: 1)"),
+    per_page: z.number().optional().default(100).describe("Jumlah data per halaman (default: 100)"),
+}, async ({ page, per_page }) => {
+    try {
+        const result = await fetchAPI("/kategori-sektoral", {
+            page,
+            per_page,
+        });
+        const formattedData = result.data.map((k) => ({
+            id: k.id,
+            nama: k.nama,
+            deskripsi: k.deskripsi || "-",
+        }));
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        total: result.total,
+                        halaman: result.current_page,
+                        total_halaman: result.last_page,
+                        kategori: formattedData,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error instanceof Error ? error.message : "Unknown error"}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Tool: Get Organisasi (Daftar OPD/Instansi)
+server.tool("get_organisasi", "Mendapatkan daftar organisasi/OPD (Organisasi Perangkat Daerah) yang ada di Kabupaten Ngawi", {
+    page: z.number().optional().default(1).describe("Nomor halaman"),
+    per_page: z.number().optional().default(100).describe("Jumlah data per halaman"),
+    q: z.string().optional().default("").describe("Kata kunci pencarian nama organisasi"),
+}, async ({ page, per_page, q }) => {
+    try {
+        const result = await fetchAPI("/organisasi", {
+            page,
+            per_page,
+            q,
+        });
+        const formattedData = result.data.map((o) => ({
+            id: o.id,
+            nama: o.nama,
+            singkatan: o.singkatan || "-",
+        }));
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        total: result.total,
+                        halaman: result.current_page,
+                        total_halaman: result.last_page,
+                        organisasi: formattedData,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error instanceof Error ? error.message : "Unknown error"}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Tool: Get Data Sektoral (Daftar Dataset)
+server.tool("get_data_sektoral", "Mendapatkan daftar data sektoral/dataset yang tersedia. Bisa difilter berdasarkan pencarian, kategori, atau organisasi.", {
+    page: z.number().optional().default(1).describe("Nomor halaman"),
+    per_page: z.number().optional().default(20).describe("Jumlah data per halaman"),
+    q: z.string().optional().default("").describe("Kata kunci pencarian"),
+    kategori_id: z.number().optional().describe("Filter berdasarkan ID kategori sektoral"),
+    organisasi_id: z.number().optional().describe("Filter berdasarkan ID organisasi"),
+}, async ({ page, per_page, q, kategori_id, organisasi_id }) => {
+    try {
+        const params = { page, per_page, q };
+        if (kategori_id)
+            params.kategori_sektoral_id = kategori_id;
+        if (organisasi_id)
+            params.organisasi_id = organisasi_id;
+        const result = await fetchAPI("/data-sektoral", params);
+        const formattedData = result.data.map((d) => ({
+            id: d.id,
+            judul: d.judul,
+            deskripsi: d.deskripsi || "-",
+            tahun: d.tahun || "-",
+            kategori: d.kategori_sektoral?.nama || "-",
+            organisasi: d.organisasi?.nama || "-",
+            sumber: d.sumber || "-",
+        }));
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        total: result.total,
+                        halaman: result.current_page,
+                        total_halaman: result.last_page,
+                        data: formattedData,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error instanceof Error ? error.message : "Unknown error"}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Tool: Get Detail Data Sektoral
+server.tool("get_detail_data", "Mendapatkan detail lengkap dari sebuah data sektoral berdasarkan ID, termasuk data detail/nilai-nilainya", {
+    id: z.number().describe("ID data sektoral yang ingin dilihat detailnya"),
+}, async ({ id }) => {
+    try {
+        const result = await fetchAPI(`/data-sektoral/${id}`);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        id: result.id,
+                        judul: result.judul,
+                        deskripsi: result.deskripsi || "-",
+                        tahun: result.tahun || "-",
+                        kategori: result.kategori_sektoral?.nama || "-",
+                        organisasi: result.organisasi?.nama || "-",
+                        sumber: result.sumber || "-",
+                        data_details: result.data_details || [],
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error instanceof Error ? error.message : "Unknown error"}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Tool: Search Data
+server.tool("search_data", "Mencari data di Satu Data Ngawi berdasarkan kata kunci. Mengembalikan data sektoral yang relevan.", {
+    keyword: z.string().describe("Kata kunci pencarian"),
+    limit: z.number().optional().default(10).describe("Jumlah hasil maksimal"),
+}, async ({ keyword, limit }) => {
+    try {
+        const result = await fetchAPI("/data-sektoral", {
+            q: keyword,
+            per_page: limit,
+            page: 1,
+        });
+        if (result.data.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Tidak ditemukan data dengan kata kunci "${keyword}"`,
+                    },
+                ],
+            };
+        }
+        const formattedData = result.data.map((d) => ({
+            id: d.id,
+            judul: d.judul,
+            kategori: d.kategori_sektoral?.nama || "-",
+            organisasi: d.organisasi?.nama || "-",
+            tahun: d.tahun || "-",
+        }));
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        keyword,
+                        total_ditemukan: result.total,
+                        hasil: formattedData,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error instanceof Error ? error.message : "Unknown error"}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Tool: Get Statistics
+server.tool("get_statistics", "Mendapatkan ringkasan statistik portal Satu Data Ngawi (jumlah kategori, organisasi, dan dataset)", {}, async () => {
+    try {
+        const [kategori, organisasi, data] = await Promise.all([
+            fetchAPI("/kategori-sektoral", { per_page: 1 }),
+            fetchAPI("/organisasi", { per_page: 1 }),
+            fetchAPI("/data-sektoral", { per_page: 1 }),
+        ]);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        statistik: {
+                            total_kategori_sektoral: kategori.total,
+                            total_organisasi: organisasi.total,
+                            total_dataset: data.total,
+                        },
+                        portal: "Satu Data Ngawi",
+                        url: "https://satudata.ngawikab.go.id",
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error instanceof Error ? error.message : "Unknown error"}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Resource: Daftar Kategori
+server.resource("kategori-list", "satudata://kategori", async () => {
+    const result = await fetchAPI("/kategori-sektoral", {
+        per_page: 100,
+    });
+    return {
+        contents: [
+            {
+                uri: "satudata://kategori",
+                mimeType: "application/json",
+                text: JSON.stringify(result.data, null, 2),
+            },
+        ],
+    };
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Satu Data Ngawi MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "mcp-satudata-ngawi",
+  "version": "1.0.0",
+  "description": "MCP Server untuk mengakses data dari Portal Satu Data Kabupaten Ngawi",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-satudata-ngawi": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "claude_desktop_config.example.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "satu-data",
+    "ngawi",
+    "open-data",
+    "indonesia",
+    "claude",
+    "anthropic"
+  ],
+  "author": "Aditya",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yourusername/mcp-satudata-ngawi.git"
+  },
+  "bugs": {
+    "url": "https://github.com/yourusername/mcp-satudata-ngawi/issues"
+  },
+  "homepage": "https://github.com/yourusername/mcp-satudata-ngawi#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}