JW.org コンテンツを扱うための MCP サーバー — 聖書のスクリプトルックアップ、ワークブック資料、Watchtower の記事、ビデオキャプション。

クイックスタート

##Claudeコード(推奨)

##Claudeデスクトップ

リリースから最新の[jw-mcp.mcpbをダウンロードし、開きます。Claude Desktopは自動的にインストールされます。

または、macOS の macOS の [%APPDATA%\Claude\claude_desktop_config.json] の config ([[T1]) に手動で追加します。

##その他のMCPクライアント(カーサー、ウィンドサーフィンなど)

お問い合わせ

Docker(セルフホスト)

パブリックHTTPS URLでマシン上でこのサーバーを実行し、URLを Grok、Claude.ai、またはChatGPTをカスタムコネクタとして貼り付けます。

コンテナをループバックにのみ結合します(127.0.0.1:8080])。 パブリックインターネット上に8080ポートを公開しないでください。 ホストに逆プロキシを置き、そこにTLSを終了し、[127.0.0.1:8080]にプロキシを終了します。

ポート 443 を使用します。 Claude.ai は他のポートのカスタムコネクタに接続しません。 「MCPサーバーに届かない」としか言いません。 Grokは他のポートを受け入れるので、[https://host:18443/mcp]のようなURLは Grokで動作し、Claudeで失敗することができます.

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/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.

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.