FaithFinder Church Search

FaithFinder MCP 服务：通过任意 AI 助手寻找教会

FaithFinder 是一款免费的美国教会查询工具。这个 模型上下文协议（MCP）服务可让 ChatGPT、Claude、Gemini、Copilot、Cursor 和其他 AI 助手根据真实、最新的教会信息回答这类问题：

• “帮我找一家靠近德克萨斯州弗里斯科、儿童事工不错的教会。”
• “我们要搬去纳什维尔。那里有改革宗或长老会教会吗？”
• “30309 附近有圣公会教会吗？”
• “达拉斯的 Watermark Community Church 怎么样？在哪里可以看他们的讲道？”
• “我不确定什么类型的教会适合我。你能帮忙吗？”

它可按城市、邮政编码、宗派、敬拜风格、儿童／青少年事工、规模和神学立场，搜索遍布美国 50 个州及哥伦比亚特区的 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

点击上方的 Install in VS Code，或将配置添加到 .vscode/mcp.json：

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

Cursor

点击上方的 Install in 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 及其他 Web 或移动应用（远程连接器）

Web 和移动聊天应用连接的是托管的 HTTPS 端点，而不是 npx。部署该服务（参见托管远程端点），然后添加：

• ChatGPT：Settings → Apps & Connectors → Developer mode → Create → URL https://<your-host>/mcp，无需身份验证。
• Claude.ai：Settings → Connectors → Add custom connector → https://<your-host>/mcp。
• 自定义 GPT Actions：导入 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。如果筛选条件过于严格，会改为搜索附近的邮政编码，并说明已放宽筛选条件。
get_church_details	关于某间教堂的问题：信仰、布道、网站、评论、附近类似的教堂。
church_match_quiz	对方不确定什么类型的教堂适合自己。返回 4 个简短问题、4 种教堂原型，以及免费的 Soul Signature 测验链接。
list_church_coverage	已覆盖哪些州和城市，以及相应数量。
search / fetch	兼容 ChatGPT connector / 深度研究的搜索与抓取（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	面向大模型的 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，并经过风险顶级域和已屏蔽域名筛查。
• 目录信息仅供发现教堂。礼拜时间和详情可能会变更，请向教堂确认。

更新日志

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 链接指向的是无关网站。
• 自然语言搜索（提取城市/州/邮政编码，支持附近邮政编码回退）。修复州名匹配问题：“CA”不再匹配 North Carolina，“TX”现在可以匹配存储为 “Texas” 的行。
• 修复了 HTTP 模式在首次请求后失效的问题。现在提供无状态 Streamable HTTP 端点和 REST API。
• 新增 MCP Registry server.json、工具注释、服务说明，以及 build:web 可抓取页面生成器。

许可证

MIT © ArmorNGlory