
advenimus/jw-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
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 Code (Recommended)
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/mcpcan work in Grok and still fail in Claude. The server logs a warning at startup whenMCP_BASE_URLhas a port.
- Copy
.env.exampleto.env. - Set
MCP_BASE_URLto your public origin, with no path and no port. Example:https://jw-mcp.example.com. - Set
MCP_AUTH_SECRETto a long access key (at least 16 characters). - Keep
MCP_AUTH=true. HTTP mode with auth off is loopback-only. Do not disable auth in Docker. - Set
MCP_TRUST_PROXY=trueonly when exactly one proxy sits in front of the server and sets or appends the real client IP inX-Forwarded-For(Caddy, nginx, or a Cloudflare Tunnel). Leave it unset otherwise. - 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.
Установка
npx -y jw-mcpКонфигурация
{
"mcpServers": {
"jw-mcp": {
"command": "npx",
"args": ["-y", "jw-mcp"]
}
}
}