# xiaozhi-mcp-bridge-template

> **Boilerplate untuk ebook "Bikin Jarvis: ESP32 Chat AI dari Nol"**
>
> Repo ini adalah **starting point** untuk bab 11–13. Anda tinggal clone,
> isi `.env`, lalu kasih prompt ke OpenCode (atau AI coding tool apapun)
> untuk nambah tool custom — tanpa nulis kode sendiri.

## 5 tool bawaan (langsung jalan)

| Tool | Untuk apa |
| --- | --- |
| `calculator` | Matematika (math + random) |
| `web_search` | Cari di web (DuckDuckGo, no API key) |
| `note_search` | Cari di note Markdown lokal |
| `read_note` | Baca note (paged untuk file besar) |
| `note_save` | Simpan note baru |
| `list_recent_notes` | List note terbaru |

## 3 tool custom (di-generate OpenCode di bab 11–13)

| Tool | Bab | Prompt |
| --- | --- | --- |
| `todo_add` + `todo_list` | 11 | `prompts/01-todo.md` |
| `timer_start` + `timer_check` + `timer_cancel` | 12 | `prompts/02-timer.md` |
| `wifi_qr_print` | 13 | `prompts/03-wifi-qr.md` |

## Quick start

```powershell
# 1. Clone repo ini
git clone https://github.com/kamilersz/xiaozhi-mcp-bridge-template xiaozhi-mcp-bridge
cd xiaozhi-mcp-bridge

# 2. Setup
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

# 3. Konfigurasi
Copy-Item .env.example .env
# Edit .env, paste MCP_ENDPOINT dari xiaozhi.me console

# 4. Jalanin
.\start.ps1
```

Lihat ebook bab 10 untuk setup lengkap (termasuk dapat MCP endpoint).

## Workflow nambah tool (bab 11–13)

1. Buka repo di OpenCode (atau AI coding tool lain):
   ```powershell
   cd xiaozhi-mcp-bridge
   opencode
   ```
2. Copy-paste prompt dari `prompts/NN-nama-tool.md`.
3. OpenCode generate kode
4. Anda review.
5. Jalankan .\start.ps1

Detail per bab di ebook.

## Lisensi

CC BY-SA 4.0. Bebas dipakai, dimodifikasi, dishare dengan syarat yang sama.