Perplexity Ask MCP Server

chính thức

Một trình kết nối cho API Perplexity để kích hoạt tìm kiếm web trong hệ sinh thái MCP.

Tài liệu

Máy chủ MCP Nền tảng API Perplexity

Triển khai máy chủ MCP chính thức cho Nền tảng API Perplexity, cung cấp cho trợ lý AI khả năng tìm kiếm web thời gian thực, suy luận và nghiên cứu thông qua các mô hình Sonar và API Tìm kiếm.

Công cụ khả dụng

perplexity_search

Tìm kiếm web trực tiếp bằng API Tìm kiếm Perplexity. Trả về kết quả tìm kiếm được xếp hạng kèm siêu dữ liệu, hoàn hảo để tìm thông tin hiện tại.

perplexity_ask

AI đàm thoại đa năng với tìm kiếm web thời gian thực sử dụng mô hình sonar-pro. Tuyệt vời cho các câu hỏi nhanh và tìm kiếm hàng ngày.

perplexity_research

Nghiên cứu sâu, toàn diện sử dụng mô hình sonar-deep-research. Lý tưởng cho phân tích kỹ lưỡng và báo cáo chi tiết.

perplexity_reason

Suy luận và giải quyết vấn đề nâng cao sử dụng mô hình sonar-reasoning-pro. Hoàn hảo cho các tác vụ phân tích phức tạp.

[!TIP] Có sẵn dưới dạng tham số tùy chọn cho perplexity_reason và perplexity_research: strip_thinking

Đặt thành true để xóa thẻ <think>...</think> khỏi phản hồi, tiết kiệm token ngữ cảnh. Mặc định: false

Cấu hình

Lấy Khóa API của bạn

Lấy Khóa API Perplexity từ Cổng API
Thay thế your_key_here trong các cấu hình bên dưới bằng khóa API của bạn
(Tùy chọn) Đặt thời gian chờ: PERPLEXITY_TIMEOUT_MS=600000 (mặc định: 5 phút)
(Tùy chọn) Đặt URL cơ sở tùy chỉnh: PERPLEXITY_BASE_URL=https://your-custom-url.com (mặc định: https://api.perplexity.ai)
(Tùy chọn) Đặt mức nhật ký: PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR (mặc định: ERROR)

Claude Code

claude mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server

Hoặc cài đặt qua plugin:

export PERPLEXITY_API_KEY="your_key_here"
claude
# Then run: /plugin marketplace add perplexityai/modelcontextprotocol
# Then run: /plugin install perplexity

Codex

codex mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server

Cursor, Claude Desktop, Kiro, Windsurf và VS Code

Hầu hết các máy khách có thể được cấu hình thủ công bằng cách sử dụng cùng một trình bao bọc mcpServers trong cấu hình máy khách của chúng (như hiển thị cho Cursor). Nếu máy khách có lược đồ khác, hãy kiểm tra tài liệu của nó để biết định dạng trình bao bọc chính xác.

Đối với thiết lập thủ công, tất cả các máy khách này đều sử dụng cùng một cấu trúc mcpServers:

Máy khách	Tệp cấu hình
Cursor	`~/.cursor/mcp.json`
Claude Desktop	`claude_desktop_config.json`
Kiro	`.kiro/settings/mcp.json`
Windsurf	`~/.codeium/windsurf/mcp_config.json`
VS Code	`.vscode/mcp.json`

{
  "mcpServers": {
    "perplexity": {
      "command": "npx",
      "args": ["-y", "@perplexity-ai/mcp-server"],
      "env": {
        "PERPLEXITY_API_KEY": "your_key_here"
      }
    }
  }
}

Thiết lập Proxy (Cho Mạng Doanh nghiệp)

Nếu bạn đang chạy máy chủ này tại nơi làm việc—đặc biệt là phía sau tường lửa hoặc proxy của công ty—bạn có thể cần cho chương trình biết cách gửi lưu lượng internet của nó qua proxy mạng của bạn. Làm theo các bước sau:

1. Lấy chi tiết proxy của bạn

Hỏi bộ phận CNTT của bạn về địa chỉ và cổng proxy HTTPS.
Bạn cũng có thể cần tên người dùng và mật khẩu.

2. Đặt biến môi trường proxy

Cách dễ nhất và đáng tin cậy nhất cho Perplexity MCP là sử dụng PERPLEXITY_PROXY. Ví dụ:

export PERPLEXITY_PROXY=https://your-proxy-host:8080

Nếu proxy của bạn cần tên người dùng và mật khẩu, hãy sử dụng:

export PERPLEXITY_PROXY=https://username:password@your-proxy-host:8080

3. Thay thế: Biến môi trường tiêu chuẩn

Nếu bạn muốn sử dụng các biến tiêu chuẩn, chúng tôi hỗ trợ HTTPS_PROXY và HTTP_PROXY.

[!NOTE] Máy chủ kiểm tra cài đặt proxy theo thứ tự này: PERPLEXITY_PROXY → HTTPS_PROXY → HTTP_PROXY. Nếu không có cái nào được đặt, nó kết nối trực tiếp với internet. URL phải bao gồm https://. Các cổng điển hình là 8080, 3128 và 80.

Triển khai Máy chủ HTTP

Đối với triển khai đám mây hoặc chia sẻ, hãy chạy máy chủ ở chế độ HTTP.

Biến Môi trường

Biến	Mô tả	Mặc định
`PERPLEXITY_API_KEY`	Khóa API Perplexity của bạn	Bắt buộc
`PERPLEXITY_BASE_URL`	URL cơ sở tùy chỉnh cho các yêu cầu API	`https://api.perplexity.ai`
`PORT`	Cổng máy chủ HTTP	`8080`
`BIND_ADDRESS`	Giao diện mạng để liên kết. Mặc định là loopback. Đặt thành `0.0.0.0` để hiển thị trên tất cả các giao diện.	`127.0.0.1`
`ALLOWED_ORIGINS`	Nguồn gốc CORS (phân tách bằng dấu phẩy). Mặc định để trống (không có yêu cầu trình duyệt cross-origin). Đặt thành danh sách cho phép rõ ràng (ví dụ: `https://app.example.com`) hoặc thành `*` để cho phép bất kỳ nguồn gốc nào.	(trống)
`ALLOWED_HOSTS`	Các giá trị tiêu đề `Host` bổ sung để chấp nhận (phân tách bằng dấu phẩy). Máy chủ loopback trên `PORT` luôn được phép. Thêm tên máy chủ công khai khi liên kết với `0.0.0.0`.	(chỉ loopback)

Docker

docker build -t perplexity-mcp-server .
docker run -p 8080:8080 -e PERPLEXITY_API_KEY=your_key_here perplexity-mcp-server

Node.js

export PERPLEXITY_API_KEY=your_key_here
npm install && npm run build && npm run start:http

Máy chủ sẽ có thể truy cập tại http://localhost:8080/mcp

Khắc phục sự cố

Sự cố Khóa API: Đảm bảo PERPLEXITY_API_KEY được đặt chính xác
Lỗi Kết nối: Kiểm tra kết nối internet và tính hợp lệ của khóa API
Không tìm thấy Công cụ: Đảm bảo gói đã được cài đặt và đường dẫn lệnh chính xác
Lỗi Thời gian chờ: Đối với các truy vấn nghiên cứu rất dài, hãy đặt PERPLEXITY_TIMEOUT_MS thành giá trị cao hơn
Sự cố Proxy: Xác minh thiết lập PERPLEXITY_PROXY hoặc HTTPS_PROXY của bạn và đảm bảo api.perplexity.ai không bị tường lửa của bạn chặn.
Lỗi EOF / Khởi tạo: Một số máy khách MCP nghiêm ngặt thất bại vì npx ghi thông báo cài đặt vào stdout. Sử dụng npx -yq thay vì npx -y để chặn đầu ra này.

Để được hỗ trợ, hãy truy cập community.perplexity.ai hoặc tạo một vấn đề.