Tripadvisor

🚀 旅评网 MCP サーバー

このサーバーは、旅評網（Tripadvisor）のコンテンツ API 用の モデルコンテキストプロトコル (MCP) サーバーです。標準化された MCP インターフェースを通じて、旅評網の場所データ、レビュー、写真にアクセスでき、AI アシスタントが旅行先や体験を検索できるようになります。

✨ 主な機能

• [x] 旅評網上の場所（ホテル、レストラン、観光名所）を検索
• [x] 特定の場所の詳細情報を取得
• [x] 場所のレビューと写真を閲覧
• [x] 座標に基づいて近くの場所を検索
• [x] API Key 認証
• [x] Docker コンテナ化サポート
• [x] AI アシスタント用のインタラクティブツールを提供

ツールリストは設定可能であり、MCP クライアントに公開するツールを選択できます。

📦 インストール

環境設定

1. 旅評網開発者プラットフォーム から旅評網コンテンツ API キーを取得します。
2. .env ファイルまたはシステム環境変数を使用して、環境変数を設定し、旅評網コンテンツ API を構成します。

# 必須：旅評網コンテンツ API 設定
TRIPADVISOR_API_KEY=your_api_key_here

3. サーバー設定をクライアント設定ファイルに追加します。例えば、Claude Desktop では以下のように設定します。

{
  "mcpServers": {
    "tripadvisor": {
      "command": "uv",
      "args": [
        "--directory",
        "<旅評網-mcp ディレクトリの完全パス>",
        "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 build -t tripadvisor-mcp-server .

Docker コンテナの直接実行

• 方法1：直接実行

docker run --rm -it -p 3001:3000 --name tripadvisor-mcp tripadvisor-mcp-server

• 方法2：設定ファイルを使用する config.json という名前の設定ファイルがある場合は、コンテナにマウントできます。

docker run --rm -it -p 3001:3000 --name tripadvisor-mcp -v $(pwd)/config.json:/app/config.json tripadvisor-mcp-server

Docker Compose を使用した実行

docker-compose.yml ファイルを作成し、以下の内容を追加します。

version: '3'
services:
  tripadvisor-mcp:
    image: tripadvisor-mcp-server
    restart: always
    ports:
      - "3001:3000"
    environment:
      - TRIPADVISOR_API_KEY=your_api_key_here

そして、以下のコマンドを実行します。

docker-compose up --build

Claude Desktop でコンテナ化されたサーバーを使用する

設定ファイルに以下の内容を追加して、Claude Desktop で Docker イメージを使用します。

{
  "mcpServers": {
    "tripadvisor": {
      "containerName": "tripadvisor-mcp",
      "image": "tripadvisor-mcp-server:latest"
    }
  }
}

💻 開発情報

プロジェクトのクローン

以下のコマンドを使用して、プロジェクトをローカルにクローンします。

git clone https://github.com/your-username/tripadvisor-mcp.git
cd tripadvisor-mcp

依存関係のインストール

プロジェクトのルートディレクトリに移動し、以下のコマンドを実行して依存関係をインストールします。

npm install

📚 プロジェクト構造

以下はプロジェクトのファイルディレクトリ構造です。

tripadvisor-mcp/
├── src/                 # ソースコードディレクトリ
│   ├── services/       # APIサービスモジュール
│   └── config.js      # 設定ファイル
├── Dockerfile          # Dockerイメージビルドファイル
├── package.json        # プロジェクトの依存関係とスクリプト設定
└── docker-compose.yml  # Docker Compose設定ファイル

🧪 テスト

テストスイートの実行

プロジェクトのルートディレクトリで、以下のコマンドを実行してすべてのテストを実行します。

npm test

テスト結果の確認

コンソールでテストの詳細出力を確認し、失敗やエラー情報がないかを確認できます。

🛠️ ツールリスト

📄 ライセンス

このプロジェクトは MIT ライセンスを使用しています。