Relationship to KBBI Daring

This project is unofficial and is not affiliated with or endorsed by the official KBBI Daring service.

Features

• MCP tool: kbbi_lookup(query: str)

• MCP resource: kbbi://{query} (same payload as kbbi_lookup)

• No login/auth flow required

• Uses official KBBI VI Daring by default

Configure in an MCP client (JSON)

Most MCP clients (including Claude Desktop) use a JSON config with a top-level mcpServers object. This mcpServers format is an emergent standard across the MCP ecosystem (see: https://gofastmcp.com/integrations/mcp-json-configuration.md).

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

uv run kbbi-mcp

{
    "mcpServers": {
        "kbbi-dev": {
            "command": "uv",
            "args": ["--directory", "/path/to/kbbi-mcp", "run", "kbbi-mcp"]
        }
    }
}

Tool: kbbi_lookup

Input

• query (string): a word or phrase

Example tool arguments:

{
    "query": "makan"
}

Output

Returns a JSON object:

• found (bool)

• query (string)

• url (string | null)

• entries (list)

• suggestions (list)

An empty query or a failed lookup (e.g. KBBI unreachable) is reported as an MCP tool error (isError: true) with a message, not as a JSON payload.

entries uses an English-key schema with normalization:

• etymology is always present (as an object or null)

• related-word lists are always present (as arrays, possibly empty)

This keeps tool output predictable across source variations.

Example tool output:

{
    "found": true,
    "query": "makan",
    "url": "https://kbbi.kemendikdasmen.go.id/entri/makan",
    "entries": [
        {
            "headword": "makan",
            "sense_number": "",
            "root_words": [],
            "pronunciation": "",
            "nonstandard_forms": [],
            "variants": [],
            "definitions": [],
            "etymology": null,
            "derived_words": [],
            "compound_words": [],
            "proverbs": [],
            "idioms": []
        }
    ],
    "suggestions": []
}

Resource: kbbi://{query}

This server also exposes the same payload as a read-only MCP resource (application/json).

• kbbi://makan

For low-level debugging, a client would read it using resources/read with {"uri": "kbbi://makan"}.

Data source

Lookup behavior:

• Official source: https://kbbi.kemendikdasmen.go.id/entri/{query}

Optional environment variables:

• KBBI_BASE_URL (default: https://kbbi.kemendikdasmen.go.id)

• KBBI_TIMEOUT_SECONDS (default: 10.0)

• KBBI_LOG_LEVEL (default: INFO): level of the server’s logs, written to stderr