Skip to main content
Glama
deenesjakoruzh
miqui

yelp-mcp-sdk

by miqui
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

yelp-mcp-sdk

공식 MCP Python SDK를 기반으로 구축된 Yelp Fusion MCP 서버입니다. yelp-mcp-min(FastMCP)과 기능적으로 동일하지만, 프레임워크 추상화 없이 저수준 Server 클래스를 직접 사용합니다.

필수 조건

Related MCP server: Yelp Fusion MCP Server

설치

uv sync
cp .env.example .env
# Edit .env and set YELP_API_KEY

실행

# stdio transport (for use with Claude Desktop or an MCP client)
uv run python -m server.main

# Docker
docker build -t yelp-mcp-sdk .
docker buildx build -t yelp-mcp-sdk .
docker run --env-file .env yelp-mcp-sdk

환경 변수

변수

필수

기본값

설명

YELP_API_KEY

예

—

Yelp Fusion API 베어러 토큰

YELP_BASE_URL

아니요

https://api.yelp.com/v3

API 기본 URL

HTTP_TIMEOUT

아니요

10.0

요청 시간 제한(초)

HTTP_MAX_RETRIES

아니요

3

429/5xx 오류 시 최대 재시도 횟수

HTTP_RETRY_WAIT_MIN

아니요

1.0

최소 백오프 대기 시간(초)

HTTP_RETRY_WAIT_MAX

아니요

10.0

최대 백오프 대기 시간(초)

LOG_LEVEL

아니요

INFO

structlog 레벨

JSON_LOGS

아니요

false

JSON 로그 라인 출력

도구

도구

Yelp 엔드포인트

설명

search_businesses

GET /v3/businesses/search

페이지네이션을 포함한 전체 텍스트 + 지리 검색

find_business_by_phone

GET /v3/businesses/search/phone

E.164 전화번호로 비즈니스 조회

match_business

GET /v3/businesses/matches

구조화된 이름+주소를 Yelp 목록과 일치

get_business

GET /v3/businesses/{id}

Yelp ID 또는 별칭으로 전체 비즈니스 프로필 조회

get_business_reviews

GET /v3/businesses/{id}/reviews

페이지네이션을 포함한 고객 리뷰

리소스

yelp://business/{id} — application/json 형식의 전체 Yelp 비즈니스 프로필입니다. list_resource_templates를 통해 선언되며 read_resource를 통해 가져옵니다.

프로젝트 구조

yelp-mcp-sdk/
  server/
    main.py              # Server("yelp-mcp", lifespan=...) + stdio run
    core/
      config.py          # pydantic-settings
      logging.py         # structlog → stderr
      client.py          # async httpx + tenacity retry
      models.py          # Pydantic output models
    handlers/
      params.py          # Pydantic input models (also generate inputSchema)
      tools.py           # list_tools() + call_tool() dispatcher
      resources.py       # list_resource_templates() + read_resource()
  tests/
    conftest.py
    test_client.py
    test_models.py
    test_handlers.py
  Dockerfile
  pyproject.toml
  .env.example

테스트 실행

uv run pytest -v

yelp-mcp-min(FastMCP)과의 비교

측면

yelp-mcp-min (FastMCP)

yelp-mcp-sdk (공식 SDK)

도구 등록

@mcp.tool() 데코레이터

list_tools + call_tool 디스패처

입력 스키마

함수 시그니처에서 자동 생성

model.model_json_schema() 명시적 사용

출력 유형

Pydantic 모델 직접 반환

JSON 문자열을 포함한 list[TextContent]

리소스

@mcp.resource("uri://...") 데코레이터

list_resource_templates + read_resource 쌍

의존성 주입

없음 (클로저를 통해 캡처)

lifespan 컨텍스트 → request_context

전송

mcp.run()

asyncio.run() + stdio_server()

서버 코드 라인 수

~350

~450

Install Server
F
license - not found
A
quality
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • Yelp Fusion AI MCP Server

    Yelp
    A
    license
    A
    quality
    D
    maintenance
    Enables conversational interactions with Yelp's business data through an MCP server, allowing natural language queries about local businesses, multi-turn conversations, and direct business inquiries powered by Yelp Fusion AI.
    1
    26
    Apache 2.0

  • Yelp Fusion MCP Server

    shawndrake2
    F
    license
    Not graded
    quality
    D
    maintenance
    Provides access to Yelp's business database for searching local businesses, retrieving detailed ratings and reviews, and performing market research through business counts. It enables users to look up businesses by location, category, or phone number using the Yelp Fusion API.
    1

  • yelp-mcp-min

    miqui
    F
    license
    A
    quality
    D
    maintenance
    Minimal MCP server for the Yelp Fusion API v3, enabling business search, phone lookup, match, details, and reviews via FastMCP.
    5

View all related MCP servers

Related MCP Connectors

  • Google Maps Scraper

    Live Google Maps business search, review, and photo data for AI agents over MCP.

  • Recreation Gov

    Recreation.gov MCP — wraps the Recreation Information Database (RIDB) API v1

  • recipes

    Recipes MCP — wraps TheMealDB API (free tier, no auth)

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/miqui/yelp-mcp-sdk'

If you have feedback or need assistance with the MCP directory API, please join our Discord server