# PDDIKTI MCP Server 🇮🇩

> mcp-name: io.github.lightnet19/pddikti-mcp-server

[![MCP Registry](https://img.shields.io/static/v1?label=MCP%20Registry&message=io.github.lightnet19%2Fpddikti-mcp-server&color=blue)](https://registry.modelcontextprotocol.io/v0/servers/io.github.lightnet19%2Fpddikti-mcp-server/versions)
[![PyPI version](https://img.shields.io/pypi/v/pddikti-mcp-server.svg)](https://pypi.org/project/pddikti-mcp-server/)



MCP server untuk mengakses **data pendidikan tinggi Indonesia (PDDIKTI)**.
Cari perguruan tinggi, dosen, program studi, dan mahasiswa — langsung dari AI assistant Anda!

## ✨ Fitur

| Tool | Deskripsi | Parameter |
|------|-----------|-----------|
| 🔍 `pddikti_search_pt` | Cari perguruan tinggi di Indonesia | `query` (nama PT) |
| 👨‍🏫 `pddikti_search_dosen` | Cari dosen berdasarkan nama/NIDN | `query`, `limit` |
| 📚 `pddikti_search_prodi` | Cari program studi | `query` |
| 🎓 `pddikti_search_mahasiswa` | Cari data mahasiswa | `query`, `limit` |
| 🏛️ `pddikti_detail_pt` | Detail lengkap perguruan tinggi | `kode_pt` |

### Contoh Penggunaan

**Cari dosen:**
```
pddikti_search_dosen(query="fuad al fajri")
```

**Cari universitas:**
```
pddikti_search_pt(query="universitas negeri malang")
```

**Detail PT:**
```
pddikti_detail_pt(kode_pt="001001")
```

## 🔧 Instalasi

```bash
pip install pddikti-mcp-server
```

## ⚙️ Konfigurasi MCP

Tambahkan ke config MCP client Anda (Claude Desktop, Hermes, dll):

```json
{
  "mcpServers": {
    "pddikti": {
      "command": "python3",
      "args": ["-m", "pddikti_mcp_server"]
    }
  }
}
```

## 🏗️ Arsitektur

Server ini menggunakan **FastMCP** dan **httpx** async untuk mengakses API PDDIKTI publik:
- **Sumber data:** [api-pddikti.vercel.app](https://api-pddikti.vercel.app/api) — oleh [ridwaanhall](https://github.com/ridwaanhall/api-pddikti)
- **Runtime:** Python ≥3.10
- **Dependencies:** fastmcp, httpx

## 📋 Pengembangan

```bash
git clone https://github.com/lightnet19/pddikti-mcp-server.git
cd pddikti-mcp-server
pip install -e .
python3 -m pddikti_mcp_server
```

## 📄 Lisensi

MIT © 2026 Fuad Al Fajri