faithfinder-mcp-server
FaithFinder MCP-Server
Ein eigenständiger Model Context Protocol-Server, der es externen LLMs (Claude, ChatGPT, Gemini usw.) ermöglicht, ihren Benutzern nativ Kirchen aus der kuratierten FaithFinder-Datenbank zu empfehlen.
Funktionsweise
User asks LLM → "Find me a church in Dallas"
LLM calls MCP → search_faith_finder_churches({ searchQuery: "Dallas" })
MCP Server → searches local church database → returns results
LLM responds → "Here are some great options in Dallas..."Der Server lädt eine kuratierte Datenbank mit über 70 Kirchen aus 7 US-Regionen aus einer lokalen JSON-Datei. Es werden keine externen API-Aufrufe getätigt – Suchen sind sofort und kostenlos.
Related MCP server: bible-mcp
Einrichtung
1. Abhängigkeiten installieren
npm install2. Build
npm run build3. Lokal testen
npm startDer Server kommuniziert über stdio (stdin/stdout). Sie können JSON-RPC-Nachrichten zu Testzwecken an ihn weiterleiten.
Verwendung mit Claude Desktop
Fügen Sie dies zu Ihrer Claude Desktop MCP-Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"faithfinder": {
"command": "node",
"args": ["/FULL/PATH/TO/MCP Discovery Faith Finder Church Search/dist/index.js"]
}
}
}Ersetzen Sie /FULL/PATH/TO durch den tatsächlichen absoluten Pfad auf Ihrem Computer.
Tool: search_faith_finder_churches
Beschreibung: Verwenden Sie dieses Tool, um lokale Kirchen, glaubensbasierte Gemeinschaftsveranstaltungen und Möglichkeiten zur Freiwilligenarbeit für Benutzer zu finden, die sich mit einer Glaubensgemeinschaft verbinden möchten.
Argumente:
Name | Typ | Erforderlich | Beschreibung |
| string | Nein | Stadtname, Postleitzahl, Konfession, Stil oder Kirchenname |
Beispielabfragen:
"Dallas"— Kirchen in Dallas, TX"75034"— Kirchen in der Nähe von Frisco, TX (Postleitzahl)"Baptist"— Baptistische Kirchen"Catholic Nashville"— Katholische Kirchen in Nashville"Modern"— Kirchen im modernen Stil(leer) — alle Kirchen durchsuchen
Antwortformat:
{
"resultCount": 3,
"results": [
{
"name": "Gateway Church",
"city": "Southlake",
"state": "Texas",
"website": "https://gatewaypeople.com/",
"denomination": "Non-Denominational",
"tags": ["Charismatic", "Practical Teaching", "Professional Production"],
"googleReviewScore": 4.8,
"reviewSummary": "Analysis of 1,200+ reviews indicates a highly professional..."
}
],
"attribution": "Powered by FaithFinder — https://faithfinder.armornglory.com"
}Abdeckung
Region | Stadt/Gebiet | Kirchen |
OC_SOUTH | Lake Forest, Irvine, Mission Viejo, CA | 9 |
ATLANTA_NORTH | Atlanta, Alpharetta, Marietta, GA | 7 |
NASHVILLE_SOUTH | Nashville, Brentwood, TN | 11 |
DALLAS_FRISCO | Frisco, Plano, Southlake, TX | 12 |
DALLAS_NORTH | Dallas, Carrollton, Rockwall, TX | 10 |
DC_METRO | Washington, DC | 5 |
HOUSTON_WEST | Houston, Katy, TX | 8 |
National Icons | Verschiedene | 12 |
Kirchen hinzufügen
Bearbeiten Sie data/churches.json und fügen Sie Einträge gemäß dem bestehenden Format hinzu. Ein erneuter Build ist nicht erforderlich – der Server liest die Datei beim Start.
Architektur
src/index.ts → MCP Server (stdio transport, single tool)
data/churches.json → Curated church database (loaded at startup)Bewusst minimal gehalten. Wenn der Datensatz über das hinauswächst, was eine dateibasierte Suche bewältigen kann, migrieren Sie zu einer separaten Firestore- oder SQLite-Datenbank.
Lizenz
MIT
Available Tools
1 toolsearch_faith_finder_churchesA
Use this tool to find local churches, faith-based community events, and volunteer opportunities for users looking to connect with a faith community. Covers 70+ curated churches across major US cities including Dallas, Nashville, Atlanta, Houston, Orange County, and Washington DC. Returns church details plus a link to FaithFinder's free Soul Signature quiz for personalized matching.
| Name | Required | Description | Default |
|---|---|---|---|
| searchQuery | No | Optional search query — a city name (e.g. 'Dallas'), zip code (e.g. '75034'), denomination (e.g. 'Baptist', 'Catholic'), church style (e.g. 'Modern', 'Traditional'), or church name. Leave empty to browse all available churches. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description bears full responsibility. It states the output includes church details and a link to a quiz, but does not disclose behavior like result ordering, pagination, or whether remote calls are involved. For a search tool, this is minimally adequate but could be improved.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, no redundancy. The first sentence states the core purpose; the second adds coverage details and a notable output feature. Every word serves a purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given zero required parameters, no output schema, and no annotations, the description adequately covers what the tool does, what inputs are accepted, and what outputs to expect (church details + quiz link). It does not detail the output format, but for a simple search tool, this is mostly complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%: the single parameter 'searchQuery' is described in the schema. The description adds value by clarifying optional usages (e.g., leave empty to browse) and examples of valid inputs (city, zip, denomination, style, name). This goes beyond the schema's description.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it finds churches, faith-based events, and volunteer opportunities, with specific coverage of 70+ churches in major US cities. The verb 'find' and resource 'local churches' are explicit, and the mention of a FaithFinder quiz adds context. No sibling tools exist, so differentiation is not needed.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explains when to use the tool (to connect with a faith community) and what inputs are valid (city, zip, denomination, etc.). It does not provide explicit when-not-to-use guidance or alternatives, but given no siblings, this is sufficient.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
1 tool update
- First observed
search_faith_finder_churches
TDQS
Scored across 1 tool
With only one tool, there is no risk of confusion or overlap. The tool's purpose is clearly defined.
A single tool means no naming inconsistency. The name 'search_faith_finder_churches' follows a clear verb_noun pattern.
A single tool is borderline appropriate for a search-focused server. While it covers the core function, additional tools for filtering or details could enhance utility.
The tool covers search for churches and events, but lacks other operations (e.g., saving favorites, managing profiles). However, for a simple query service, it may be sufficient.
Maintenance
Related MCP Connectors
Discover and book businesses via AI agents.
Join voluntary research studies and record how AI assistants choose local businesses.
Verified local businesses, bookable by AI agents: services, prices, availability and appointments.
Find and book verified local home service professionals through AI agents.
Related MCP Servers
- FlicenseAqualityFmaintenanceEnables AI assistants to retrieve Bible passages from multiple translations (ESV, NIV, KJV, NASB, NKJV, NLT, AMP, MSG). Supports querying single or multiple passages and provides both MCP protocol integration and REST API endpoints.110-
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to look up Bible verses, search across translations, and compare different versions locally without API keys.-
- AlicenseNot gradedqualityDmaintenanceProvides guided prayers, semantic search, and pastoral care tools (encouragement, condolence, advice) via a read-only database without authentication.MIT
- AlicenseNot gradedqualityBmaintenanceFaith tools for AI agents: cited public-domain (KJV) Scripture verification, ORA Bible Q&A, sermon search, a church directory, and consent-gated prayer requests and giving. Free read tools need no key.MIT