vineverse-mcp

호스팅되는 VineVerse MCP 서버로 연결하는 stdio 브리지입니다 — 성경을 지식 그래프로 제공합니다.

클라이언트가 streamable HTTP를 지원한다면 이 패키지가 필요 없습니다. 엔드포인트를 직접 지정하기만 하면 됩니다.

https://vineverse.bible/api/mcp

API 키도 계정도 필요 없습니다. 이 패키지는 로컬 프로세스만 실행할 수 있는 클라이언트를 위해 있으며, 해당 프로세스와 호스팅된 서버 사이에서 JSON-RPC 메시지를 전달하는 것 외에는 아무것도 하지 않습니다.

설치하기

// claude_desktop_config.json, or any client's equivalent
{
  "mcpServers": {
    "vineverse": {
      "command": "npx",
      "args": ["-y", "github:DataCraftsmanAU/vineverse-mcp"]
    }
  }
}

또는 Docker:

docker build -t vineverse-mcp .
docker run -i --rm vineverse-mcp

Node 20 이상이 필요합니다. 의존성은 없습니다.

Related MCP server: KARP Word Graph

그 뒤에 있는 것

공개 도메인의 성경과 공개적으로 라이선스된 학술 자료를 기반으로 만든, 변경할 수 없는 Open Knowledge Format 문서 12,761개 묶음입니다:

출처와 해당 라이선스는 vineverse.bible/attribution에기재되어 있습니다. 이 저장소의 MIT 라이선스는 데이터 마루미가 아닌 브리지를 다룹니다.

도구

15개, 호스팅된 서버에서 그대로 제공됩니다 — 이 패키지는 아무것도 추가하거나 여과하지 않습니다.

설정

사이트의 로컬 checkout에 대해 실행할 때 유용합니다:

VINEVERSE_MCP_URL=http://localhost:3100/api/mcp node index.js

테스트

npm run build   # syntax check — there is nothing to compile
npm test

CI는 매 푸시와 매주 예약된 시간에 Node 20 및 24에서 실행됩니다. 예약된 실행은 의도적입니다. 테스트가 실제 엔드포인트와 통신하기 때문이지, 몇 달 동안 변경되지 않는 저장소의 녹색 배지는 여전히 서버가 오늘도 응답한다는 의미입니다.

build는 호스팅된 빌더(그 중이에서 Glama)가 무조건 install 후 build를 실행하기 때문에 존재합니다. 빈 작업 대신 node --check를 실행합니다. 이것이 의존성이 없는 단일 파일이 가질 수 있는유일한 의미 있는 빌드 단계입니다.

테스트는 모듈을 임포트하지 않고 실제 자식 프로세스를 만든다. 확인하는네 가지 중 두 가지 — 알림이 응답을 만들지 않는다는 것과 응답을 잘라내지 않고 종료 코드 0으로 나간다는 것 — 은 프로세스의 속성이며, 함수의 속성이 아니기 때문입니다.

브리지를 실제 자식 프로세스로 실행하고 stdio로 제어합니다: initialize, notifications/initialized, tools/list, 그 다음에 John 3:16에 대한 get_passage 호출입니다. 실제 운영 중인 엔드포인트와 통신하므로, 실패 시 브리지 또는 호스팅된 서버 중 하나에 문제가 있다는 뜻입니다.