Skip to main content
Glama
deenesjakoruzh
miqui

yelp-mcp-sdk

by miqui
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

yelp-mcp-sdk

Servidor MCP de Yelp Fusion construido sobre el SDK oficial de MCP para Python. Funcionalmente idéntico a yelp-mcp-min (FastMCP), pero utiliza la clase Server de bajo nivel directamente, sin abstracciones de framework.

Requisitos previos

Related MCP server: Yelp Fusion MCP Server

Instalación

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

Ejecución

# 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

Variables de entorno

Variable

Requerida

Predeterminado

Descripción

YELP_API_KEY

Sí

—

Token de portador de la API de Yelp Fusion

YELP_BASE_URL

No

https://api.yelp.com/v3

URL base de la API

HTTP_TIMEOUT

No

10.0

Tiempo de espera de solicitud en segundos

HTTP_MAX_RETRIES

No

3

Intentos máximos de reintento en 429/5xx

HTTP_RETRY_WAIT_MIN

No

1.0

Espera mínima de retroceso en segundos

HTTP_RETRY_WAIT_MAX

No

10.0

Espera máxima de retroceso en segundos

LOG_LEVEL

No

INFO

Nivel de structlog

JSON_LOGS

No

false

Emitir líneas de registro JSON

Herramientas

Herramienta

Endpoint de Yelp

Descripción

search_businesses

GET /v3/businesses/search

Búsqueda de texto completo + geo con paginación

find_business_by_phone

GET /v3/businesses/search/phone

Buscar un negocio por número de teléfono E.164

match_business

GET /v3/businesses/matches

Emparejar nombre+dirección estructurados con listado de Yelp

get_business

GET /v3/businesses/{id}

Perfil de negocio completo por ID o alias de Yelp

get_business_reviews

GET /v3/businesses/{id}/reviews

Reseñas de clientes con paginación

Recurso

yelp://business/{id} — Perfil de negocio completo de Yelp como application/json. Declarado mediante list_resource_templates; obtenido mediante read_resource.

Estructura del proyecto

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

Ejecución de pruebas

uv run pytest -v

Comparación con yelp-mcp-min (FastMCP)

Aspecto

yelp-mcp-min (FastMCP)

yelp-mcp-sdk (SDK oficial)

Registro de herramientas

Decorador @mcp.tool()

Despachador list_tools + call_tool

Esquema de entrada

Generado automáticamente desde la firma de la función

model.model_json_schema() explícito

Tipo de salida

Devuelve el modelo Pydantic directamente

list[TextContent] con cadena JSON

Recursos

Decorador @mcp.resource("uri://...")

Par list_resource_templates + read_resource

Inyección de dependencias

Ninguna (capturada mediante cierre)

Contexto lifespan → request_context

Transporte

mcp.run()

asyncio.run() + stdio_server()

LOC del servidor

~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