KBBI MCP server

kbbi-mcp

.. mcp-name: io.github.gaato/kbbi-mcp

.. image:: https://img.shields.io/github/actions/workflow/status/gaato/kbbi-mcp/ci.yml?label=CI :target: https://github.com/gaato/kbbi-mcp/actions/workflows/ci.yml :alt: CI

.. image:: https://img.shields.io/pypi/v/kbbi-mcp :target: https://pypi.org/project/kbbi-mcp/ :alt: PyPI

.. image:: https://img.shields.io/pypi/pyversions/kbbi-mcp :target: https://pypi.org/project/kbbi-mcp/ :alt: Python

.. image:: https://img.shields.io/pypi/l/kbbi-mcp :target: https://github.com/gaato/kbbi-mcp/blob/HEAD/LICENSE.md :alt: License

.. image:: https://img.shields.io/badge/VSCode-InstallServer-0098FF :target: https://insiders.vscode.dev/redirect/mcp/install?name=kbbi&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22kbbi-mcp%22%5D%7D :alt: Install in VS Code

.. image:: https://img.shields.io/badge/Cursor-Install_Server-000000?logo=cursor :target: https://cursor.com/en/install-mcp?name=kbbi&config=eyJjb21tYW5kIjoidXZ4IGtiYmktbWNwIn0%3D :alt: Install in Cursor

An MCP server that lets AI assistants look up Indonesian words in KBBI _ (Kamus Besar Bahasa Indonesia), the official Indonesian dictionary. It returns structured entries (homographs, pronunciation, root words, word classes, definitions, and examples) so the assistant can explain, translate, or quote them for you.

This is an unofficial client; see Disclaimer_.

Example prompts

• What does "gemas" mean according to KBBI?
• Apa arti kata "mempunyai"? Apa kata dasarnya?
• Explain "layarnya tidak makan" using KBBI.

Getting started

The server runs locally over stdio with uv _'s uvx; no API key or account is needed. Most clients accept this standard config:

.. code-block:: json

{ "mcpServers": { "kbbi": { "command": "uvx", "args": ["kbbi-mcp"] } } }

Claude Code ~~~~~~~~~~~

.. code-block:: bash

claude mcp add kbbi -- uvx kbbi-mcp

Codex CLI ~~~~~~~~~

.. code-block:: bash

codex mcp add kbbi -- uvx kbbi-mcp

Gemini CLI ~~~~~~~~~~

.. code-block:: bash

gemini mcp add kbbi uvx kbbi-mcp

VS Code ~~~~~~~

Click the Install in VS Code badge at the top, or run:

.. code-block:: bash

code --add-mcp '{"name":"kbbi","command":"uvx","args":["kbbi-mcp"]}'

Cursor ~~~~~~

Click the Install in Cursor badge at the top, or add the standard config to ~/.cursor/mcp.json (or .cursor/mcp.json in a project).

Claude Desktop ~~~~~~~~~~~~~~

Open Settings → Developer → Edit Config and add the standard config to claudedesktopconfig.json:

• macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
• Windows: %APPDATA%\Claude\claudedesktopconfig.json

Other clients ~~~~~~~~~~~~~

Use the standard config above. Without uv, install the package with pip install kbbi-mcp and use kbbi-mcp (or python -m kbbi_mcp) as the command.

Tools

number, pronunciation, root words, and senses (labels such as the word class, the definition, and examples with their meanings). Read-only.

• kbbi_lookup: Look up an Indonesian word or phrase in KBBI. Returns each headword with its homograph

• query (string, required): a word or phrase, e.g. makan or rumah sakit

An empty query or a failed lookup (e.g. KBBI unreachable) is returned as a tool error. The full result structure is published as the tool's outputSchema (kbbi_mcp.types in Python).

Resources

• kbbi://{query}: the same result as kbbi_lookup, as JSON (e.g. kbbi://makan).

Configuration

Optional environment variables:

Shortened. The full README is on GitHub.