Skip to main content
Glama
deenesjakoruzh
miqui

yelp-mcp-sdk

by miqui
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

yelp-mcp-sdk

MCP-сервер для Yelp Fusion, построенный на официальном Python SDK для 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

Базовый URL API

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}

Полный профиль компании по ID или алиасу Yelp

get_business_reviews

GET /v3/businesses/{id}/reviews

Отзывы клиентов с пагинацией

Ресурс

yelp://business/{id} — Полный профиль компании Yelp в формате application/json. Объявлен через 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 напрямую

list[TextContent] с JSON-строкой

Ресурсы

Декоратор @mcp.resource("uri://...")

Пара list_resource_templates + read_resource

Внедрение зависимостей

Нет (через замыкания)

Контекст lifespan → request_context

Транспорт

mcp.run()

asyncio.run() + stdio_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