Tripadvisor MCP

by pab1it0
Verified
MIT License
  • Linux
  • Apple

Integrations

  • Supports containerized deployment with Docker for isolation and easy setup, including configuration options for running the MCP server within Docker containers.

  • Provides access to Tripadvisor's Content API, enabling search for travel destinations, hotels, restaurants, and attractions, as well as retrieving detailed location information, reviews, photos, and nearby points of interest.

トリップアドバイザーMCPサーバー

Tripadvisor コンテンツ API 用のモデル コンテキスト プロトコル(MCP) サーバー。

これにより、標準化された MCP インターフェースを通じて Tripadvisor の位置データ、レビュー、写真にアクセスできるようになり、AI アシスタントが旅行先や体験を検索できるようになります。

特徴

  • [x] トリップアドバイザーで場所(ホテル、レストラン、観光スポット)を検索する
  • [x] 特定の場所の詳細情報を取得する
  • [x] 場所のレビューと写真を取得する
  • [x] 座標に基づいて近くの場所を検索する
  • [x] APIキー認証
  • [x] Dockerコンテナ化のサポート
  • [x] AIアシスタントのためのインタラクティブツールを提供する

ツールのリストは構成可能なので、MCP クライアントで使用できるようにするツールを選択できます。

使用法

  1. トリップアドバイザー開発者ポータルからトリップアドバイザー コンテンツ API キーを取得します。
  2. .envファイルまたはシステム環境変数を使用して、Tripadvisor コンテンツ API の環境変数を設定します。
# Required: Tripadvisor Content API configuration TRIPADVISOR_API_KEY=your_api_key_here
  1. サーバー設定をクライアント設定ファイルに追加します。例えば、Claude Desktopの場合は以下のようになります。
{ "mcpServers": { "tripadvisor": { "command": "uv", "args": [ "--directory", "<full path to tripadvisor-mcp directory>", "run", "src/tripadvisor_mcp/main.py" ], "env": { "TRIPADVISOR_API_KEY": "your_api_key_here" } } } }

注意: Claude Desktop でError: spawn uv ENOENT表示される場合は、 uvへのフル パスを指定するか、構成で環境変数NO_UV=1を設定する必要があります。

Dockerの使用

このプロジェクトには、簡単な展開と分離を実現する Docker サポートが含まれています。

Dockerイメージの構築

次を使用して Docker イメージをビルドします。

docker build -t tripadvisor-mcp-server .

Dockerで実行する

Docker を使用してサーバーを実行するにはいくつかの方法があります。

docker run を直接使用する:

docker run -it --rm \ -e TRIPADVISOR_API_KEY=your_api_key_here \ tripadvisor-mcp-server

docker-compose を使用する:

Tripadvisor API キーを使用して.envファイルを作成し、次を実行します。

docker-compose up

Claude Desktop で Docker を実行する

Claude Desktop でコンテナ化されたサーバーを使用するには、環境変数を使用して Docker を使用するように構成を更新します。

{ "mcpServers": { "tripadvisor": { "command": "docker", "args": [ "run", "--rm", "-i", "-e", "TRIPADVISOR_API_KEY", "tripadvisor-mcp-server" ], "env": { "TRIPADVISOR_API_KEY": "your_api_key_here" } } } }

この構成では、変数名のみを指定した-eフラグを使用し、 envオブジェクトに実際の値を指定して、Claude Desktop から Docker コンテナーに環境変数を渡します。

発達

貢献を歓迎します!ご提案や改善点がありましたら、問題を報告するか、プルリクエストを送信してください。

このプロジェクトは依存関係の管理にuvを使用しています。お使いのプラットフォームの手順に従ってuvをインストールしてください。

curl -LsSf https://astral.sh/uv/install.sh | sh

次に、次のコマンドで仮想環境を作成し、依存関係をインストールします。

uv venv source .venv/bin/activate # On Unix/macOS .venv\Scripts\activate # On Windows uv pip install -e .

プロジェクト構造

プロジェクトはsrcディレクトリ構造で構成されています:

tripadvisor-mcp/ ├── src/ │ └── tripadvisor_mcp/ │ ├── __init__.py # Package initialization │ ├── server.py # MCP server implementation │ ├── main.py # Main application logic ├── Dockerfile # Docker configuration ├── docker-compose.yml # Docker Compose configuration ├── .dockerignore # Docker ignore file ├── pyproject.toml # Project configuration └── README.md # This file

テスト

このプロジェクトには、機能性を保証し、回帰を防ぐのに役立つテスト スイートが含まれています。

pytest でテストを実行します。

# Install development dependencies uv pip install -e ".[dev]" # Run the tests pytest # Run with coverage report pytest --cov=src --cov-report=term-missing

ツール

道具カテゴリ説明
search_locations検索クエリテキスト、カテゴリ、その他のフィルターで場所を検索します
search_nearby_locations検索特定の座標の近くの場所を見つける
get_location_details検索場所の詳細情報を取得する
get_location_reviews検索場所のレビューを取得する
get_location_photos検索場所の写真を取得する

ライセンス

マサチューセッツ工科大学


-
security - not tested
A
license - permissive license
-
quality - not tested

LLM がトリップアドバイザー API と対話できるようにする MCP サーバー。標準化された MCP インターフェースを通じて、位置データ、レビュー、写真をサポートします。

  1. Features
    1. Usage
      1. Docker Usage
        1. Building the Docker Image
        2. Running with Docker
        3. Running with Docker in Claude Desktop
      2. Development
        1. Project Structure
          1. Testing
          2. Tools
        2. License
          ID: 9p0vzeo2lj