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