AJ

advenimus/jw-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

43 stars 6 forks Качество 69 Тренд 20

MCP Инструменты для Свидетелей Иеговы

Обзор

Сервер MCP для работы с контентом JW.org — поиск библейских писаний с заметками об исследовании, материалами книги, статьями Сторожевой Башни и видеоподписями. Загрузите последний jw-mcp.mcpb из Releases и откройте его — Claude Desktop установит его автоматически. Или добавить вручную в конфигурацию (~/Library/Application Support/Claude/claude desktop config.json на macOS, %APPDATA%\Claude\claude desktop config.json на Windows): Запустите этот сервер на машине с общедоступным URL HTTPS, а затем вставьте этот URL в Grok, Claude.ai или ChatGPT в качестве пользовательского разъема. Композиция связывает контейнер только с обратной связью (127.0.0.1:8080). Не публикуйте порт 8080 в Интернете. Поместите обратный прокси на хост, прекратите TLS там и прокси до 127.0.0.1:8080. 1. Copy .env.example to .env. 2. Set MCP BASE URL to your public origin, with no path. Пример: https://jw-mcp.example.com. 3. Установите MCP AUTH SECRET на длинный ключ доступа (не менее 16 символов). 4.Сохранить MCP AUTH=true.

Обзор (машинный перевод)

Сервер MCP для работы с контентом JW.org — поиск библейских писаний с заметками об исследовании, материалами книги, статьями Сторожевой Башни и видеоподписями.

Быстрый старт

###Код Клода (рекомендуется)

###Клод Десктоп

Загрузите последнюю версию T0 из Releases и откройте ее — Claude Desktop установит ее автоматически.

Или добавить вручную в конфигурацию ~/Library/Application Support/Claude/claude_desktop_config.json на macOS, %APPDATA%\Claude\claude_desktop_config.json на Windows:

Другие клиенты MCP (Cursor, Windsurf и т. Д.)

Docker (самостоятельно)

Запустите этот сервер на машине с общедоступным URL HTTPS, а затем вставьте этот URL в Grok, Claude.ai или ChatGPT в качестве пользовательского разъема.

Композиция связывает контейнер только с обратной связью ([T3]). Не публикуйте порт 8080 в Интернете. Поставьте обратный прокси на хост, прекратите TLS там и прокси на 127.0.0.1:8080.

Используйте порт 443. Claude.ai никогда не подключается к пользовательскому разъему на любом другом порту. Надпись гласит: «Не удалось добраться до MCP-сервера». Grok принимает другие порты, поэтому URL-адрес, такой как https://host:18443/mcp, может работать в Grok и все еще не работает в Claude.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

JW MCP Server

An MCP server for working with JW.org content — Bible scripture lookup with study notes, workbook materials, Watchtower articles, and video captions.

Quick Start

claude mcp add jw-mcp -- npx -y jw-mcp

Claude Desktop

Download the latest jw-mcp.mcpb from Releases and open it — Claude Desktop will install it automatically.

Or add manually to your config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "jw-mcp": {
      "command": "npx",
      "args": ["-y", "jw-mcp"]
    }
  }
}

Other MCP Clients (Cursor, Windsurf, etc.)

npx -y jw-mcp

Docker (self-hosted)

Run this server on a machine with a public HTTPS URL, then paste that URL into Grok, Claude.ai, or ChatGPT as a custom connector.

Compose binds the container to loopback only (127.0.0.1:8080). Do not publish port 8080 on the public internet. Put a reverse proxy on the host, terminate TLS there, and proxy to 127.0.0.1:8080.

Use port 443. Claude.ai never connects to a custom connector on any other port. It only says “Couldn’t reach the MCP server”. Grok accepts other ports, so a URL like https://host:18443/mcp can work in Grok and still fail in Claude. The server logs a warning at startup when MCP_BASE_URL has a port.

  1. Copy .env.example to .env.
  2. Set MCP_BASE_URL to your public origin, with no path and no port. Example: https://jw-mcp.example.com.
  3. Set MCP_AUTH_SECRET to a long access key (at least 16 characters).
  4. Keep MCP_AUTH=true. HTTP mode with auth off is loopback-only. Do not disable auth in Docker.
  5. Set MCP_TRUST_PROXY=true only when exactly one proxy sits in front of the server and sets or appends the real client IP in X-Forwarded-For (Caddy, nginx, or a Cloudflare Tunnel). Leave it unset otherwise.
  6. Start it:
docker compose up --build -d

The connector URL is:

https://your-host/mcp

When you add the connector, the AI site opens a login page. Type the same access key you put in MCP_AUTH_SECRET.

Client Where to add it
Grok grok.com/connectors → New Connector → Custom
Claude.ai Customize → Connectors → Add custom connector
ChatGPT Settings → enable Developer mode → add the server URL

Local HTTP (http://localhost:8080) is fine for testing because compose binds loopback. Claude, ChatGPT, and Grok must reach a public HTTPS URL. A tunnel such as ngrok or Cloudflare Tunnel can expose that loopback port for a live click-test. Do not publish 8080 on 0.0.0.0.

Открыть полный README на GitHub

Установка

npx -y jw-mcp
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "jw-mcp": { "command": "npx", "args": ["-y", "jw-mcp"] } } }