Skip to main content
Glama
deenesjakoruzh
miqui

yelp-mcp-sdk

by miqui
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

yelp-mcp-sdk

Yelp Fusion MCP-Server, basierend auf dem offiziellen MCP Python SDK. Funktionell identisch mit yelp-mcp-min (FastMCP), verwendet jedoch direkt die Low-Level-Server-Klasse — ohne Framework-Abstraktionen.

Voraussetzungen

Related MCP server: Yelp Fusion MCP Server

Installation

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

Ausführung

# 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

Umgebungsvariablen

Variable

Erforderlich

Standardwert

Beschreibung

YELP_API_KEY

Ja

—

Yelp Fusion API Bearer-Token

YELP_BASE_URL

Nein

https://api.yelp.com/v3

API-Basis-URL

HTTP_TIMEOUT

Nein

10.0

Request-Timeout in Sekunden

HTTP_MAX_RETRIES

Nein

3

Maximale Wiederholungsversuche bei 429/5xx

HTTP_RETRY_WAIT_MIN

Nein

1.0

Minimale Wartezeit bei Back-off in Sekunden

HTTP_RETRY_WAIT_MAX

Nein

10.0

Maximale Wartezeit bei Back-off in Sekunden

LOG_LEVEL

Nein

INFO

structlog-Level

JSON_LOGS

Nein

false

JSON-Logzeilen ausgeben

Tools

Tool

Yelp-Endpunkt

Beschreibung

search_businesses

GET /v3/businesses/search

Volltext- + Geo-Suche mit Paginierung

find_business_by_phone

GET /v3/businesses/search/phone

Suche nach Unternehmen per E.164-Telefonnummer

match_business

GET /v3/businesses/matches

Abgleich von Name+Adresse mit Yelp-Eintrag

get_business

GET /v3/businesses/{id}

Vollständiges Unternehmensprofil per Yelp-ID oder Alias

get_business_reviews

GET /v3/businesses/{id}/reviews

Kundenbewertungen mit Paginierung

Ressource

yelp://business/{id} — Vollständiges Yelp-Unternehmensprofil als application/json. Deklariert über list_resource_templates; abgerufen über read_resource.

Projektstruktur

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

Tests ausführen

uv run pytest -v

Vergleich mit yelp-mcp-min (FastMCP)

Aspekt

yelp-mcp-min (FastMCP)

yelp-mcp-sdk (offizielles SDK)

Tool-Registrierung

@mcp.tool()-Dekorator

list_tools + call_tool-Dispatcher

Eingabe-Schema

Automatisch aus Funktionssignatur

model.model_json_schema() explizit

Ausgabetyp

Rückgabe direkt als Pydantic-Modell

list[TextContent] mit JSON-String

Ressourcen

@mcp.resource("uri://...")-Dekorator

list_resource_templates + read_resource-Paar

Dependency Inject

Keine (via Closure erfasst)

lifespan-Kontext → request_context

Transport

mcp.run()

asyncio.run() + stdio_server()

Server-LOC

~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