トリップアドバイザー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-serverdocker-compose を使用する:
Tripadvisor API キーを使用して.envファイルを作成し、次を実行します。
docker-compose upClaude 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ツール
道具 | カテゴリ | 説明 |
| 検索 | クエリテキスト、カテゴリ、その他のフィルターで場所を検索します |
| 検索 | 特定の座標の近くの場所を見つける |
| 検索 | 場所の詳細情報を取得する |
| 検索 | 場所のレビューを取得する |
| 検索 | 場所の写真を取得する |
ライセンス
マサチューセッツ工科大学