mcp-bible

성경 도우미 MCP 서버. 다역본 구절 조회(원어·렉시콘 단계 공개), keyword/semantic 검색, 관주, 단어연구를 Hermes 같은 에이전트에 도구로 노출한다. 결제 스킬(skill/bible.skill.md)이 목회적 톤·웨슬리안 사변형 해석틀로 답을 묶는다.

도구 = "사실"(본문·원어·관주·렉시콘), 스킬 = "의미"(해석·공감·분별). 표준: 프로젝트 공통 STANDARD.md(레퍼런스 mcp-qr).

---

도구

도구	설명	주요 인자
lookup	구절 조회 (다역본 동시·원어·렉시콘 단계 공개)	reference, versions?, include_original?, include_lexicon?
search	본문 검색 — keyword(부분일치) / semantic(의미)	query, mode?, limit?
cross_references	관주(교차 참조), 관련도 순	reference, limit?
word_study	원어 단어 → Strong's → 어원·뜻	reference, word?, strongs?
list_versions	사용 가능 역본(로컬 포함)	—
list_books	성경 66권 목록	—

reference는 "John 3:16" · "요한복음 3장 16절" · "요 3:16" · "GEN.1.1" · 범위 "John 3:16-18" 모두 받는다.

역본 / 데이터

id	역본	언어	라이선스
krv	개역한글	ko	PD (대한성서공회 표기·본문 변형 금지)
bsb	Berean Standard Bible	en	CC0
kjv	King James Version	en	PD
wlc	히브리어 WLC + 형태소	he	PD + 형태소 CC BY 4.0
berean-grk	Berean Greek NT	grc	CC0

추가: Strong's 렉시콘(히/헬), OpenBible 관주(~34만), BGE-M3 의미검색 임베딩(텍스트 3역본). 출처·라이선스·표기 의무 전체는 NOTICE 참조. (SBLGNT은 EULA 모호성으로 미번들.)

설치

git clone https://github.com/molpass/mcp-bible.git
cd mcp-bible
npm install && npm run build

데이터 준비 (data/bible.sqlite + 임베딩)

무거운 파생물(텍스트+형태소+관주 DB 146MB, 임베딩 .bin)은 git이 아니라 GitHub Release 자산으로 배포된다.

• 권장(빠름): Release에서 bible.sqlite(+필요 시 embeddings/*.bin)를 받아 data/에 둔다.
• 직접 빌드:

  npm run fetch       # 공개 소스 다운로드 → data/sources/ (gitignored)
  npm run build:db    # 정규화 + G1 정렬 게이트 + data/bible.sqlite (FTS 없이도 동작)
  npm run build:embeddings   # 의미검색용 BGE-M3 사전계산 → data/embeddings/*.bin  (DEEPINFRA_TOKEN 필요)
  

lookup·keyword 검색·word_study·관주는 bible.sqlite만 있으면 오프라인 동작. semantic 검색만 질의당 임베딩 1회를 위해 DEEPINFRA_TOKEN(env)이 필요하며, 없으면 자동으로 keyword로 대체된다.

Hermes / MCP 등록

서버명은 bible:

{
  "mcpServers": {
    "bible": {
      "command": "node",
      "args": ["/abs/path/mcp-bible/dist/index.js"],
      "env": { "DEEPINFRA_TOKEN": "<선택 — semantic 검색용>" }
    }
  }
}

/abs/path는 클론한 실제 절대경로. Windows 예: "C:/Users/<you>/mcp-bible/dist/index.js".

로컬 역본 (개역개정 등)

data/local/<version_id>.json을 두면 자동으로 역본 목록에 등장하고 기본 역본이 된다(있을 때). 형식·정책은 data/local/README.md 참조. 로컬 본문은 비공개 — git에 절대 커밋되지 않는다.

설계 노트

• bible.sqlite(146MB)·임베딩은 GitHub 100MB 한도 때문에 Release 자산(git 미포함).
• 런타임 DB 엔진은 node:sqlite(빌트인, 무네이티브빌드). 이 빌드는 FTS5 미포함이라 keyword 검색은 LIKE(부분일치). DB 접근은 src/db.ts 단일 모듈로 격리(향후 better-sqlite3 교체 가역).
• semantic은 오프라인 아님(질의 임베딩 DeepInfra 1회) → 토큰 없으면 keyword 폴백.
• 내부 4분할(corpus-loader / verse-id / search / skill)로 향후 다종교 코퍼스(예: sutra/quran) 골격 재사용.

스킬

페어링 스킬: skill/bible.skill.md — 트리거(성경·기독교) → 도구 매핑, 목회적 톤, 단일-synthesis 호출 규약.

About / 제작

Hermes Agent용 MCP — molpass의 바이브 코딩(vibe coding) 프로젝트.

• 아이디어·방향: molpass (이정훈) · https://zeolinex.com
• 기획: Claude (Chat)
• 개발: Claude Code

같은 모음:

• mcp-saju · mcp-qr · mcp-biorhythm · mcp-astrology · mcp-ziwei · mcp-numerology · mcp-liuren · mcp-qimen · mcp-taiyi · mcp-weather · mcp-newsfeed
• mcp-bible (이 repo)

License

MIT (코드) — 데이터 출처·라이선스는 NOTICE.