Bible MCP 서버

AI 어시스턴트가 성경 구절을 조회하고, 여러 번역본을 검색하며, 동일한 구절이 각 버전에서 어떻게 표현되는지 비교할 수 있게 해주는 MCP 서버입니다.

Bible-json 데이터셋을 기반으로 구축되었습니다. 38개 이상의 언어로 된 100개 이상의 버전을 모두 로컬에서 API 키 없이 사용할 수 있습니다.

이 서버가 필요한 이유

대부분의 성경 API는 사용량 제한이 있거나, 키가 필요하거나, 지원하는 버전이 제한적입니다. 실제 텍스트 데이터는 자유롭게 이용 가능하지만, 이를 AI 도구에 연동하는 과정은 여전히 번거롭습니다.

이 서버는 그 문제를 해결합니다. 데이터를 복제하고, 바이너리를 빌드한 뒤, MCP 클라이언트를 연결하기만 하면 됩니다. 이제 AI가 원격 서비스를 호출하지 않고도 모든 버전의 성경 구절을 불러올 수 있습니다.

성경 공부 앱을 개발하거나, 신학 연구를 하거나, 단순히 Claude가 성경 구절을 찾아보길 원한다면 이 서버가 시간을 절약해 줄 것입니다.

Related MCP server: KARP Word Graph

제공 기능

모두 읽기 전용이며 로컬에서 실행되는 7가지 도구:

버전 이름은 유연하게 입력할 수 있습니다. "KJV", "King James Bible" 또는 부분 일치 검색도 가능합니다. 성경 권 이름도 동일한 방식으로 작동합니다.

빠른 시작

1. 성경 데이터 가져오기

git clone https://github.com/Amosamevor/Bible-json.git ~/Bible-json

2. 설치 및 빌드

git clone https://github.com/stackpwnies/bible-mcp.git
cd bible-mcp
bun install
bun run build

Bun이 필요합니다. 설치되어 있지 않다면 설치하세요. 개발 중에는 빌드 단계를 건너뛰고 bun run src/index.ts를 직접 실행할 수도 있습니다.

3. MCP 클라이언트에 추가

Claude Code (~/.claude.json 또는 프로젝트 .mcp.json):

{
  "mcpServers": {
    "bible": {
      "command": "/path/to/bible-mcp/bin/bible-mcp",
      "env": { "BIBLE_DATA_ROOT": "/path/to/Bible-json" }
    }
  }
}

Cursor / VS Code (.cursor/mcp.json):

{
  "mcpServers": {
    "bible": {
      "command": "/path/to/bible-mcp/bin/bible-mcp",
      "env": { "BIBLE_DATA_ROOT": "/path/to/Bible-json" }
    }
  }
}

빌드 없이 실행 (소스에서 직접 실행):

{
  "mcpServers": {
    "bible": {
      "command": "bun",
      "args": ["run", "/path/to/bible-mcp/src/index.ts"],
      "env": { "BIBLE_DATA_ROOT": "/path/to/Bible-json" }
    }
  }
}

예시

연결이 완료되면 AI 어시스턴트가 다음과 같은 작업을 수행할 수 있습니다:

"KJV 버전으로 요한복음 3장 16절을 찾아줘"

"KJV, NIV, ESV, NLT 버전으로 시편 23편 1절을 비교해줘"

"KJV에서 'valley of the shadow of death'를 검색해줘"

"사용 가능한 영어 성경 버전은 무엇인가요?"

"NIV 버전으로 고린도전서 13장 전체를 보여줘"

"킹제임스 성경에는 총 몇 권의 책이 있나요?"

지원 언어

영어, 중국어, 스페인어, 프랑스어, 독일어, 포르투갈어, 러시아어, 아랍어, 히브리어, 그리스어, 한국어, 이탈리아어, 네덜란드어, 스웨덴어, 핀란드어, 헝가리어, 체코어, 크로아티아어, 알바니아어, 덴마크어, 터키어, 태국어, 베트남어, 인도네시아어, 바스크어, 라틴어, 라트비아어, 마오리어, 스와힐리어, 우크라이나어, 아르메니아어. 일부 언어는 여러 버전을 지원합니다. 영어는 44개 버전을 지원합니다.

작동 원리

서버는 처음 액세스할 때 성경 JSON 파일을 로드하며, 가장 최근에 사용된 5개 버전을 메모리에 유지합니다. 데이터베이스나 별도의 실행 서버, 네트워크 호출이 필요 없습니다. 디스크에 있는 파일을 필요할 때 읽어오며, 반복적인 조회를 빠르게 하기 위해 캐싱합니다.

버전 해석은 약어(KJV), 전체 이름(King James Bible), 퍼지 매칭을 지원합니다. 성경 권 이름도 동일하게 작동합니다.

요구 사항

• Bun

• Bible-json 데이터셋 (별도 복제 필요)

라이선스

MIT

감사의 말

• 성경 데이터셋을 제공해 준 Amosamevor/Bible-json

• 오픈 프로토콜을 제공하는 Model Context Protocol