FaithFinder Church Search

FaithFinder MCP サーバー：あらゆるAIアシスタントから教会を探す

FaithFinder は、米国の教会を無料で検索できるサービスです。このModel Context Protocol（MCP）サーバーを使うと、ChatGPT、Claude、Gemini、Copilot、CursorなどのAIアシスタントが、実際の最新の教会情報をもとに、次のような質問に答えられます。

• 「テキサス州フリスコ近郊で、子ども向けプログラムが充実した教会を探して」
• 「ナッシュビルに引っ越す予定です。改革派または長老派の教会はありますか？」
• 「郵便番号30309の近くに聖公会の教会はありますか？」
• 「ダラスのWatermark Community Churchはどんな教会ですか？説教動画はどこで見られますか？」
• 「自分に合う教会の種類がよくわかりません。相談に乗ってもらえますか？」

全米50州とワシントンD.C.にある9,000以上のキリスト教会を、都市、郵便番号、教派、礼拝スタイル、子ども・青少年向けプログラム、規模、神学的見解で検索できます。検索結果には、教会のウェブサイト、最新の説教動画、信仰声明、Googleの評価、FaithFinderのプロフィールへのリンクが含まれます。

APIキーもアカウントも不要で、ネットワークへの接続もありません。データはパッケージに含まれており、メモリ内で検索されます。

---

クイックスタート

Claude Desktop

claude_desktop_config.json に追加します（macOS：~/Library/Application Support/Claude/、Windows：%APPDATA%\Claude\）。

{
  "mcpServers": {
    "faithfinder": {
      "command": "npx",
      "args": ["-y", "faithfinder-mcp-server@latest"]
    }
  }
}

Claude Code

claude mcp add faithfinder -- npx -y faithfinder-mcp-server@latest

VS Code / GitHub Copilot

上の VS Codeにインストール をクリックするか、.vscode/mcp.json に追加します。

{ "servers": { "faithfinder": { "command": "npx", "args": ["-y", "faithfinder-mcp-server@latest"] } } }

Cursor

上の Cursorにインストール をクリックするか、Claude DesktopのJSONを ~/.cursor/mcp.json に追加します。

Windsurf

Claude DesktopのJSONを ~/.codeium/windsurf/mcp_config.json に追加します。

Gemini CLI

gemini mcp add faithfinder npx -y faithfinder-mcp-server@latest

ChatGPT、Claude.ai、その他のウェブ・モバイルアプリ（リモートコネクター）

ウェブ・モバイルのチャットアプリは、npx ではなくホストされたHTTPSエンドポイントに接続します。サーバーをデプロイして（リモートエンドポイントのホスティングを参照）、次の設定を追加します。

• ChatGPT：Settings → Apps & Connectors → Developer mode → Create → URL https://<your-host>/mcp、認証なし。
• Claude.ai：Settings → Connectors → Add custom connector → https://<your-host>/mcp。
• カスタムGPTアクション：https://<your-host>/openapi.json または openai-action.json をインポートします。

---

ツール

ツール	アシスタントが使用する場面
find_churches	「近くの教会を探して…」というリクエストに使います。自然言語（"contemporary church with kids ministry in Plano TX"）に加えて、任意で city、state、zipCode、denomination、worshipStyle、hasKidsMinistry、churchSize、theology、limit を指定できます。該当する結果がない場合は近隣の ZIP コードを検索し、フィルター条件を緩和したことを伝えます。
get_church_details	1 つの教会について、信仰、説教、ウェブサイト、レビュー、近くにある類似の教会を尋ねる場合に使います。
church_match_quiz	どのような教会が自分に合うのか分からない場合に使います。4 つの短い質問、4 種類の教会の類型、無料の Soul Signature クイズへのリンクを返します。
list_church_coverage	対応している州や都市と、それぞれの件数を確認する場合に使います。
search / fetch	ChatGPT コネクター／ディープリサーチに対応した検索と取得（OpenAI MCP 仕様）です。

すべてのツールは読み取り専用（readOnlyHint: true）で、副作用はありません。

リソース： faithfinder://overview、faithfinder://coverage、faithfinder://theology-and-styles プロンプト： find_a_church、church_search_advisor

---

リモートエンドポイントのホスティング

PORT が設定されている場合、または --http を指定した場合、HTTP モードが自動的に有効になります。ステートレスな Streamable HTTP MCP エンドポイントと、小規模な REST API が起動します。

パス	目的
POST /mcp	MCP エンドポイント（ChatGPT、Claude.ai、あらゆるリモート MCP クライアント向け）
GET /api/churches/search?q=…	REST 検索（Custom GPT Actions で使用）
GET /api/churches/{id or name}	REST 教会詳細
GET /api/quiz/archetypes	REST クイズフレームワーク
GET /openapi.json	OpenAPI 3.1 仕様（サーバー URL は PUBLIC_BASE_URL から設定されます）
GET /.well-known/mcp.json	MCP 検出カード
GET /health	ヘルスチェック

# Local
PORT=8080 PUBLIC_BASE_URL=http://localhost:8080 npm start

# Google Cloud Run (from this folder; scales to zero)
gcloud run deploy faithfinder-mcp --source . --region us-central1 --allow-unauthenticated \
  --set-env-vars PUBLIC_BASE_URL=https://<service-url>

デプロイ後、server.json に remotes エントリ（{"type": "streamable-http", "url": "https://<host>/mcp"}）を追加し、MCP Registry に再公開します。

---

AI 検索エンジン向けのクロール可能なウェブページ（npm run build:web）

AI 回答エンジン（ChatGPT Search、Perplexity、Google AI Overviews、Copilot）は JavaScript を実行しないため、実際の HTML として存在するページのみを引用できます。このコマンドは同じデータからページを生成します。

npm run build:web          # -> ./web-kit

出力	内容
us/、us/{state}/、us/{state}/{city}/	全国、州、都市のディレクトリ（ItemList + FAQPage JSON-LD）
church/{state}/{city}/{slug}/	教会ごとのページ（schema.org Church JSON-LD）
llms.txt、llms-full.txt	LLM 向けの llms.txt 概要と全件インデックス
robots.txt、sitemap.xml	GPTBot、OAI-SearchBot、ClaudeBot、PerplexityBot、Google-Extended などを許可し、すべてのページを一覧表示します

FaithFinder ウェブアプリは、ビルド時に web-kit/ を dist/ にコピーします（scripts/copy_web_kit.js）。MCP サーバーのプロフィールリンクはこれらのページを参照します。

---

リンク

• ウェブサイト：https://faithfinder.armornglory.com
• 教会ディレクトリ：https://faithfinder.armornglory.com/us/
• Soul Signature クイズ：https://faithfinder.armornglory.com/quiz
• npm：https://www.npmjs.com/package/faithfinder-mcp-server
• MCP Registry 名：io.github.ArmorNGlory/faithfinder-mcp-server

プライバシーとセキュリティ

• クエリはメモリー上で処理されます。マシン外へのログ記録やテレメトリーの送信はありません。
• すべての外部リンクは HTTPS にアップグレードされ、リスクのある TLD やブロック対象のドメインに対してチェックされます。
• 掲載情報は教会を探すためのものです。礼拝時間や詳細は変更される場合があるため、教会にご確認ください。

変更履歴

2.0.0

• 破壊的変更：ツール名を見つけやすいものに変更しました。search_faith_finder_churches → find_churches、get_faith_finder_church_details → get_church_details、get_soul_signature_quiz → church_match_quiz。list_church_coverage、search、fetchを追加しました。
• すべてのリンクの参照先をfaithfinder.armornglory.comに変更しました。古いfaithfinder.appのリンクは無関係なサイトを指していました。
• 自然言語検索（市区町村／州／ZIPコードの抽出、近隣のZIPコードへのフォールバック）。州名の照合を修正しました。「CA」がノースカロライナ州に誤一致しなくなり、「TX」が「Texas」として保存された行にも一致するようになりました。
• 最初のリクエスト後に失敗していたHTTPモードを修正しました。ステートレスなStreamable HTTPエンドポイントとREST APIを追加しました。
• MCP Registryのserver.json、ツールのアノテーション、サーバーの指示、クロール可能なページを生成するbuild:webを追加しました。

ライセンス

MIT © ArmorNGlory