Tripadvisor

🚀 旅評網 MCP 服務器

該服務器是一個用於旅評網（Tripadvisor）內容 API 的 模型上下文協議 (MCP) 服務器。藉助標準化的 MCP 接口，它能提供對旅評網的位置數據、評論和照片的訪問，助力人工智能助手搜索旅行目的地和體驗。

✨ 主要特性

• [x] 可搜索旅評網上的位置，涵蓋酒店、餐廳、景點等。
• [x] 能夠獲取特定位置的詳細信息。
• [x] 支持查看位置的評論和照片。
• [x] 可根據座標搜索附近的地點。
• [x] 具備 API Key 認證功能。
• [x] 支持 Docker 容器化。
• [x] 為 AI 助手提供交互式工具。

工具列表可配置，您能自由選擇對 MCP 客戶端開放的工具。

🚀 快速開始

準備工作

1. 從 旅評網開發者平臺 獲取您的旅評網內容 API 密鑰。

2. 配置環境變量以設置旅評網內容 API，可通過 .env 文件或系統環境變量進行配置：

# 必填：旅評網內容 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 容器

• 方式一：直接運行

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

• 方式二：使用配置文件 若您有一個名為 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 許可證。