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

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

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

特徴

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

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

Related MCP server: mcp-llm

使用法

トリップアドバイザー開発者ポータルからトリップアドバイザーコンテンツ API キーを取得します。
.envファイルまたはシステム環境変数を使用して、Tripadvisor コンテンツ API の環境変数を設定します。

# Required: Tripadvisor Content API configuration TRIPADVISOR_API_KEY=your_api_key_here

サーバー設定をクライアント設定ファイルに追加します。例えば、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`	検索	場所の写真を取得する