Perplexity Ask MCP Server
chính thứcMộ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.
Bạn có thể làm gì với Perplexity Ask MCP?
- Tìm kiếm web theo thời gian thực — Yêu cầu kết quả tìm kiếm hiện tại, được xếp hạng với bộ lọc độ mới, giới hạn tên miền hoặc chế độ nhanh qua
perplexity_search. - Hỏi đáp hội thoại — Nhận câu trả lời nhanh, dựa trên web cho các câu hỏi hàng ngày bằng công cụ
perplexity_ask. - Báo cáo nghiên cứu chuyên sâu — Yêu cầu phân tích toàn diện, nhiều bước cho các cuộc điều tra kỹ lưỡng qua
perplexity_research. - Suy luận nâng cao — Giải quyết các vấn đề phân tích phức tạp với phương pháp giải quyết từng bước thông qua
perplexity_reason. - Độ sâu tìm kiếm tùy chỉnh — Kiểm soát ngữ cảnh tìm kiếm được truy xuất bằng cách đặt ngân sách
max_tokensvàmax_tokens_per_pagecho các công cụ ask và reason.
Tài liệu
Máy chủ MCP Nền tảng API Perplexity
Bản triển khai máy chủ MCP chính thức cho Nền tảng API Perplexity, cung cấp cho các trợ lý AI khả năng tìm kiếm web theo thời gian thực, suy luận và nghiên cứu thông qua Agent API và Search API.
Máy chủ MCP Từ xa
Máy chủ MCP từ xa được Perplexity lưu trữ và là cách dễ nhất để bắt đầu: cùng các công cụ, không cần cài đặt hoặc cập nhật gì. Các nút Cursor và VS Code ở đầu trang này kết nối với máy chủ chỉ bằng một cú nhấp chuột. Nếu máy khách MCP của bạn chưa hỗ trợ máy chủ từ xa, hãy chuyển đến phần thiết lập máy chủ cục bộ bên dưới. Kết nối qua Streamable HTTP với khóa API Perplexity của bạn:
https://api.perplexity.ai/mcp
Đối với Claude Code:
claude mcp add --transport http perplexity https://api.perplexity.ai/mcp --header "Authorization: Bearer YOUR_API_KEY"
Xem tài liệu tích hợp MCP để biết cấu hình thủ công Cursor/VS Code, cách sử dụng từ Anthropic API và thiết lập cho các máy khách khác.
Máy chủ MCP Cục bộ
Lấy Khóa API của Bạn
- Lấy Khóa API Perplexity của bạn từ Cổng API
- Thay thế
your_key_heretrong 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 độ ghi log:
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
Plugin Agent
Kho lưu trữ này được đóng gói dưới dạng Agent Plugin, vì vậy các máy khách hỗ trợ tiêu chuẩn này có thể cài đặt trực tiếp từ kho lưu trữ này. Định dạng Agent Plugins không mang bí mật, vì vậy hãy đặt biến môi trường PERPLEXITY_API_KEY thông qua cài đặt plugin hoặc MCP của máy khách.
Máy khách MCP Khác
Hầu hết các máy khách có thể được cấu hình thủ công bằng cùng trình bao bọc mcpServers trong cấu hình máy khách của họ (như được 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 họ để biết định dạng trình bao bọc chính xác.
Đối với thiết lập thủ công, các máy khách này đều sử dụng cùng 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 (Dành 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à 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 truy cập internet qua proxy của mạng. Hãy làm theo các bước sau:
1. Lấy thông tin proxy của bạn
- Hỏi bộ phận IT của bạn về địa chỉ và cổng proxy HTTPS của bạn.
- 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.
[!LƯU Ý] 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 đặt nào được đặt, máy chủ kết nối trực tiếp với internet. URL phải bao gồmhttps://. Các cổng điển hình là8080,3128và80.
Chế độ HTTP Tự lưu trữ
Đối với các triển khai đám mây hoặc dùng chung, 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 chéo nguồn gốc). Đặ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). Các 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
Các Công cụ Có sẵn
perplexity_search
Kết quả tìm kiếm bao gồm ngày xuất bản và ngày cập nhật lần cuối khi có sẵn. Ngày bị thiếu hoặc null được bỏ qua khỏi đầu ra được định dạng.
Tìm kiếm web trực tiếp bằng Perplexity Search API. Trả về kết quả tìm kiếm được xếp hạng với siêu dữ liệu, hoàn hảo để tìm thông tin hiện tại. Hỗ trợ bộ lọc gần đây (search_recency_filter), hạn chế tên miền (search_domain_filter) và Fast Search (search_type: "fast") để có độ trễ và chi phí thấp hơn.
perplexity_ask
AI hội thoại đa năng với tìm kiếm web theo thời gian thực, được hỗ trợ bởi cài đặt trước Agent API fast. 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 được hỗ trợ bởi cài đặt trước Agent API high. Lý tưởng cho phân tích kỹ lưỡng và báo cáo chi tiết. Các lần chạy có thể mất vài phút; máy chủ truyền phát lần chạy và báo cáo tiến trình cho các máy khách yêu cầu.
perplexity_reason
Suy luận nâng cao và giải quyết vấn đề được hỗ trợ bởi cài đặt trước Agent API medium. Hoàn hảo cho các nhiệm vụ phân tích phức tạp.
perplexity_ask và perplexity_reason chấp nhận max_tokens số nguyên dương tùy chọn (tổng ngữ cảnh tìm kiếm, tối đa 120.000) và max_tokens_per_page (ngữ cảnh trên mỗi trang kết quả, tối đa 20.000). Các ngân sách Agent API này kiểm soát nội dung tìm kiếm được truy xuất, không phải độ dài câu trả lời được tạo. Khi bỏ qua, cấu hình tìm kiếm của cài đặt trước vẫn có hiệu lực.
Đối số search_context_size kế thừa vẫn được chấp nhận, nhưng được dịch cục bộ thành ngân sách rõ ràng thay vì gửi đến Agent API:
| Kích thước kế thừa | Tổng token | Token trên mỗi trang |
|---|---|---|
low | 2000 | 512 |
medium | 4000 | 1024 |
high | 8000 | 2048 |
Chính sách tương thích này không phải là tương đương chính xác với các kích thước được đặt tên của Sonar; hướng dẫn di chuyển Agent API không có tương đương kích thước được đặt tên. Mỗi ngân sách rõ ràng ghi đè mặc định kế thừa tương ứng của nó.
[!LƯU Ý] Cài đặt trước là các cấu hình được quản lý (mô hình, thiết lập tìm kiếm, ngân sách bước) mà Perplexity giữ điều chỉnh theo thời gian; xem hướng dẫn cài đặt trước. Các phiên bản trước của máy chủ này gọi các mô hình
sonar-pro,sonar-reasoning-provàsonar-deep-researchkế thừa và chấp nhận các tham sốstrip_thinking/reasoning_effort. Các tham số đó không còn là một phần của lược đồ công cụ và bị bỏ qua nếu được gửi; Agent API không tạo thẻ<think>.
Sử dụng như một Thư viện
Gói này cũng xuất khẩu nhà máy máy chủ để nhúng vào quy trình Node của riêng bạn:
import { createPerplexityServer } from "@perplexity-ai/mcp-server";
// Single-tenant: reads PERPLEXITY_API_KEY from the environment.
const server = createPerplexityServer("my-service");
// Multi-tenant hosts resolve the key per call instead. When a provider is
// set, the environment variable is never consulted, and a provider that
// returns no key fails the call rather than falling back.
const tenantServer = createPerplexityServer("my-service", {
apiKey: () => currentRequestApiKey,
});
Gắn máy chủ được trả về trên bất kỳ phương tiện truyền tải MCP nào (stdio, streamable HTTP, in-memory).
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 của bạn
- 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 Hết 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_MSthành giá trị cao hơn - Sự cố Proxy: Xác minh thiết lập
PERPLEXITY_PROXYhoặcHTTPS_PROXYcủa bạn và đảm bảoapi.perplexity.aikhông bị tường lửa chặn. - Lỗi EOF / Khởi tạo: Một số máy khách MCP nghiêm ngặt không thành công vì
npxghi thông báo cài đặt vào stdout. Sử dụngnpx -yqthay vìnpx -yđể ngăn chặn đầu ra này.
Để được hỗ trợ, hãy truy cập community.perplexity.ai hoặc gửi sự cố.