Skip to main content
Glama
ArmorNGlory

faithfinder-mcp-server

FaithFinder MCP 서버

외부 LLM(Claude, ChatGPT, Gemini 등)이 FaithFinder의 엄선된 데이터베이스에서 교회를 사용자에게 기본적으로 추천할 수 있도록 하는 독립형 Model Context Protocol 서버입니다.

작동 방식

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

이 서버는 로컬 JSON 파일에서 미국 7개 지역의 70개 이상의 엄선된 교회 데이터베이스를 로드합니다. 외부 API 호출이 없으므로 검색이 즉각적이고 무료입니다.

Related MCP server: bible-mcp

설정

1. 종속성 설치

npm install

2. 빌드

npm run build

3. 로컬 테스트

npm start

서버는 stdio(stdin/stdout)를 통해 통신합니다. 테스트를 위해 JSON-RPC 메시지를 파이프로 전달할 수 있습니다.

Claude Desktop과 함께 사용하기

Claude Desktop MCP 설정(~/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"]
    }
  }
}

/FULL/PATH/TO를 사용 중인 머신의 실제 절대 경로로 바꾸십시오.

도구: search_faith_finder_churches

설명: 신앙 공동체와 연결되기를 원하는 사용자를 위해 지역 교회, 신앙 기반 커뮤니티 행사 및 자원봉사 기회를 찾을 때 이 도구를 사용하세요.

인수:

이름

유형

필수

설명

searchQuery

string

아니요

도시 이름, 우편번호, 교파, 스타일 또는 교회 이름

예시 쿼리:

  • "Dallas" — 텍사스주 댈러스의 교회

  • "75034" — 텍사스주 프리스코 근처의 교회(우편번호)

  • "Baptist" — 침례교회

  • "Catholic Nashville" — 내슈빌의 가톨릭 교회

  • "Modern" — 현대적인 스타일의 교회

  • (비어 있음) — 모든 교회 둘러보기

응답 형식:

{
  "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"
}

커버리지

지역

도시/지역

교회 수

OC_SOUTH

레이크 포레스트, 어바인, 미션 비에호, CA

9

ATLANTA_NORTH

애틀랜타, 알파레타, 마리에타, GA

7

NASHVILLE_SOUTH

내슈빌, 브렌트우드, TN

11

DALLAS_FRISCO

프리스코, 플레이노, 사우스레이크, TX

12

DALLAS_NORTH

댈러스, 캐럴턴, 록월, TX

10

DC_METRO

워싱턴 DC

5

HOUSTON_WEST

휴스턴, 케이티, TX

8

National Icons

기타

12

교회 추가

data/churches.json을 편집하고 기존 형식을 따라 항목을 추가하세요. 재빌드가 필요하지 않으며, 서버가 시작될 때 파일을 읽습니다.

아키텍처

src/index.ts    → MCP Server (stdio transport, single tool)
data/churches.json → Curated church database (loaded at startup)

의도적으로 최소화했습니다. 데이터 세트가 파일 기반 검색으로 처리할 수 있는 범위를 넘어서면 별도의 Firestore 또는 SQLite 데이터베이스로 마이그레이션하세요.

라이선스

MIT

Available Tools

1 tool
search_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.

ParametersJSON Schema
NameRequiredDescriptionDefault
searchQueryNoOptional 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

A4.2/5.0
Behavior3/5

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.

Conciseness5/5

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.

Completeness4/5

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.

Parameters4/5

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.

Purpose5/5

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.

Usage Guidelines4/5

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. 1 tool update
    • First observedsearch_faith_finder_churches

TDQS

A4.1/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no risk of confusion or overlap. The tool's purpose is clearly defined.

Naming Consistency5/5

A single tool means no naming inconsistency. The name 'search_faith_finder_churches' follows a clear verb_noun pattern.

Tool Count3/5

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.

Completeness3/5

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

ActivitySlowing
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • F
    license
    A
    quality
    F
    maintenance
    Enables 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.
    1
    10
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to look up Bible verses, search across translations, and compare different versions locally without API keys.
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides guided prayers, semantic search, and pastoral care tools (encouragement, condolence, advice) via a read-only database without authentication.
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Faith 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