MCP 服务器

Bible MCP

Enables local-first semantic search and retrieval of Korean Bible verses using FAISS embeddings and full-text indexes. Supports exploration of biblical entities including people, places, and events with Korean-to-English query handling.

README

bible-mcp

bible-mcp is a local-first Korean Bible MCP server. It imports verses from a source SQLite database, builds passage chunks and search indexes, and serves those indexes through an MCP server.

V2 metadata slice: metadata is fetched and synced explicitly before indexing. bible-mcp index now depends on metadata that was already synced into the app DB.

V2 entity search defaults to people for backwards compatibility; to search bundled place or event metadata, call search_entities with an explicit entity_type such as places or events.

Client-Side Entity Retry

Bible MCP assumes entity rewrite happens in the MCP client when Korean input needs English metadata retries. The server exposes route_entity_query, but the retry loop stays in the client layer.

See docs/integrations/llm-entity-rewrite.md for the integration contract and retry flow.

Setup

Create and activate a virtual environment.
Install the project in editable mode with dev dependencies: pip install -e '.[dev]'
Set BIBLE_SOURCE_DB to a SQLite database that contains the source verses table. The importer expects at least book, chapter, verse, and text, and it can also read optional translation.
Fetch theographic metadata snapshot: bible-mcp fetch-theographic
Sync fetched metadata into the app DB: bible-mcp sync-theographic
Run indexing (offline; does not fetch metadata remotely): bible-mcp index
Start the MCP server: bible-mcp serve

Commands

bible-mcp fetch-theographic downloads the configured theographic snapshot into the local vendor directory.
bible-mcp sync-theographic normalizes the fetched snapshot and syncs metadata rows into the app database.
bible-mcp index imports source verses, requires already-synced metadata, rebuilds chunks and FTS indexes, and writes FAISS embeddings. It is offline and does not fetch metadata remotely.
bible-mcp serve validates the app database and FAISS artifacts, then starts the MCP server. When optional metadata tables are available it also exposes entity search and entity relation tools.
bible-mcp doctor validates the source database and the generated runtime artifacts without starting the server.