Perplexity Ask MCP Server

เซิร์ฟเวอร์ MCP แพลตฟอร์ม Perplexity API

     

การใช้งานเซิร์ฟเวอร์ MCP อย่างเป็นทางการสำหรับแพลตฟอร์ม Perplexity API ซึ่งให้ความสามารถในการค้นหาเว็บแบบเรียลไทม์ การใช้เหตุผล และการวิจัยแก่ผู้ช่วย AI ผ่าน Agent API และ Search API

เซิร์ฟเวอร์ MCP ระยะไกล

เซิร์ฟเวอร์ MCP ระยะไกลโฮสต์โดย Perplexity และเป็นวิธีที่ง่ายที่สุดในการเริ่มต้นใช้งาน: เครื่องมือเดียวกัน ไม่ต้องติดตั้งหรืออัปเดตอะไร ปุ่ม Cursor และ VS Code ที่ด้านบนของหน้านี้เชื่อมต่อได้ด้วยคลิกเดียว หากไคลเอนต์ MCP ของคุณยังไม่รองรับเซิร์ฟเวอร์ระยะไกล ให้ข้ามไปที่การตั้งค่า เซิร์ฟเวอร์ท้องถิ่น ด้านล่าง เชื่อมต่อผ่าน Streamable HTTP ด้วย คีย์ API ของ Perplexity ของคุณ:

https://api.perplexity.ai/mcp

สำหรับ Claude Code:

claude mcp add --transport http perplexity https://api.perplexity.ai/mcp --header "Authorization: Bearer YOUR_API_KEY"

ดู เอกสารการผสานรวม MCP สำหรับการกำหนดค่า Cursor/VS Code ด้วยตนเอง การใช้งานจาก Anthropic API และการตั้งค่าสำหรับไคลเอนต์อื่นๆ

เซิร์ฟเวอร์ MCP ท้องถิ่น

รับคีย์ API ของคุณ

1. รับคีย์ API ของ Perplexity จาก พอร์ทัล API
2. แทนที่ your_key_here ในการกำหนดค่าด้านล่างด้วยคีย์ API ของคุณ
3. (ไม่บังคับ) ตั้งค่าหมดเวลา: PERPLEXITY_TIMEOUT_MS=600000 (ค่าเริ่มต้น: 5 นาที)
4. (ไม่บังคับ) ตั้งค่า URL พื้นฐานที่กำหนดเอง: PERPLEXITY_BASE_URL=https://your-custom-url.com (ค่าเริ่มต้น: https://api.perplexity.ai)
5. (ไม่บังคับ) ตั้งค่าระดับบันทึก: PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR (ค่าเริ่มต้น: ERROR)

Claude Code

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

หรือติดตั้งผ่านปลั๊กอิน:

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

ไคลเอนต์ MCP อื่นๆ

ไคลเอนต์ส่วนใหญ่สามารถกำหนดค่าด้วยตนเองได้โดยใช้ตัวครอบ mcpServers เดียวกันในการกำหนดค่าไคลเอนต์ (ตามที่แสดงสำหรับ Cursor) หากไคลเอนต์มีรูปแบบ schema ที่แตกต่างกัน ให้ตรวจสอบเอกสารของไคลเอนต์นั้นสำหรับรูปแบบตัวครอบที่แน่นอน

สำหรับการตั้งค่าด้วยตนเอง ไคลเอนต์เหล่านี้ทั้งหมดใช้โครงสร้าง mcpServers เดียวกัน:

ไคลเอนต์	ไฟล์กำหนดค่า
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"
      }
    }
  }
}

การตั้งค่าพร็อกซี (สำหรับเครือข่ายองค์กร)

หากคุณรันเซิร์ฟเวอร์นี้ที่ทำงาน—โดยเฉพาะอย่างยิ่งอยู่หลังไฟร์วอลล์หรือพร็อกซีของบริษัท—คุณอาจต้องบอกโปรแกรมถึงวิธีส่งการรับส่งข้อมูลอินเทอร์เน็ตผ่านพร็อกซีของเครือข่ายของคุณ ทำตามขั้นตอนเหล่านี้:

1. รับรายละเอียดพร็อกซีของคุณ

• สอบถามแผนกไอทีของคุณสำหรับที่อยู่และพอร์ตพร็อกซี HTTPS
• คุณอาจต้องใช้ชื่อผู้ใช้และรหัสผ่านด้วย

2. ตั้งค่าตัวแปรสภาพแวดล้อมพร็อกซี

วิธีที่ง่ายและน่าเชื่อถือที่สุดสำหรับ Perplexity MCP คือการใช้ PERPLEXITY_PROXY ตัวอย่างเช่น:

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

หากพร็อกซีของคุณต้องใช้ชื่อผู้ใช้และรหัสผ่าน ให้ใช้:

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

3. ทางเลือก: ตัวแปรสภาพแวดล้อมมาตรฐาน

หากคุณต้องการใช้ตัวแปรมาตรฐาน เรารองรับ HTTPS_PROXY และ HTTP_PROXY

[!NOTE] เซิร์ฟเวอร์ตรวจสอบการตั้งค่าพร็อกซีตามลำดับนี้: PERPLEXITY_PROXY → HTTPS_PROXY → HTTP_PROXY หากไม่มีการตั้งค่าใด เซิร์ฟเวอร์จะเชื่อมต่ออินเทอร์เน็ตโดยตรง URL ต้องรวม https:// พอร์ตทั่วไปคือ 8080, 3128 และ 80

โหมด HTTP แบบโฮสต์เอง

สำหรับการปรับใช้บนคลาวด์หรือแบบแชร์ ให้รันเซิร์ฟเวอร์ในโหมด HTTP

ตัวแปรสภาพแวดล้อม

ตัวแปร	คำอธิบาย	ค่าเริ่มต้น
PERPLEXITY_API_KEY	คีย์ API ของ Perplexity ของคุณ	จำเป็น
PERPLEXITY_BASE_URL	URL พื้นฐานที่กำหนดเองสำหรับคำขอ API	https://api.perplexity.ai
PORT	พอร์ตเซิร์ฟเวอร์ HTTP	8080
BIND_ADDRESS	อินเทอร์เฟซเครือข่ายที่จะผูก เริ่มต้นที่ loopback ตั้งค่าเป็น 0.0.0.0 เพื่อเปิดเผยบนอินเทอร์เฟซทั้งหมด	127.0.0.1
ALLOWED_ORIGINS	ต้นทาง CORS (คั่นด้วยเครื่องหมายจุลภาค) เริ่มต้นที่ว่างเปล่า (ไม่อนุญาตคำขอข้ามต้นทางจากเบราว์เซอร์) ตั้งค่าเป็นรายการอนุญาตที่ชัดเจน (เช่น https://app.example.com) หรือเป็น * เพื่ออนุญาตทุกต้นทาง	(ว่างเปล่า)
ALLOWED_HOSTS	ค่าส่วนหัว Host เพิ่มเติมที่ยอมรับ (คั่นด้วยเครื่องหมายจุลภาค) โฮสต์ loopback บน PORT อนุญาตเสมอ เพิ่มชื่อโฮสต์สาธารณะเมื่อผูกกับ 0.0.0.0	(เฉพาะ 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

เซิร์ฟเวอร์จะเข้าถึงได้ที่ http://localhost:8080/mcp

เครื่องมือที่มีให้

perplexity_search

การค้นหาเว็บโดยตรงโดยใช้ Perplexity Search API ส่งคืนผลการค้นหาที่จัดอันดับพร้อมข้อมูลเมตา เหมาะสำหรับการค้นหาข้อมูลปัจจุบัน รองรับตัวกรองความใหม่ (search_recency_filter) และข้อจำกัดโดเมน (search_domain_filter)

perplexity_ask

AI เชิงสนทนาวัตถุประสงค์ทั่วไปพร้อมการค้นหาเว็บแบบเรียลไทม์ รองรับโดยพรีเซ็ต Agent API fast เหมาะสำหรับคำถามด่วนและการค้นหาในชีวิตประจำวัน

perplexity_research

การวิจัยเชิงลึกและครอบคลุม รองรับโดยพรีเซ็ต Agent API high เหมาะสำหรับการวิเคราะห์อย่างละเอียดและรายงานโดยละเอียด การรันอาจใช้เวลาหลายนาที เซิร์ฟเวอร์สตรีมการรันและรายงานความคืบหน้าให้กับไคลเอนต์ที่ร้องขอ

perplexity_reason

การใช้เหตุผลขั้นสูงและการแก้ปัญหา รองรับโดยพรีเซ็ต Agent API medium เหมาะสำหรับงานวิเคราะห์ที่ซับซ้อน

[!NOTE] พรีเซ็ตคือการกำหนดค่าที่จัดการ (โมเดล การตั้งค่าการค้นหา งบประมาณขั้นตอน) ที่ Perplexity ปรับแต่งอยู่ตลอดเวลา ดู คู่มือพรีเซ็ต เซิร์ฟเวอร์เวอร์ชันก่อนหน้าเรียกโมเดล sonar-pro, sonar-reasoning-pro และ sonar-deep-research แบบเดิม และยอมรับพารามิเตอร์ strip_thinking / reasoning_effort พารามิเตอร์เหล่านั้นไม่เป็นส่วนหนึ่งของ schema เครื่องมืออีกต่อไปและจะถูกละเว้นหากส่งมา Agent API ไม่สร้างแท็ก <think>

ใช้เป็นไลบรารี

แพ็คเกจยังส่งออก factory ของเซิร์ฟเวอร์สำหรับฝังในกระบวนการ Node ของคุณเอง:

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,
});

เมานต์เซิร์ฟเวอร์ที่ส่งคืนบน transport MCP ใดๆ (stdio, streamable HTTP, in-memory)

การแก้ไขปัญหา

• ปัญหาคีย์ API: ตรวจสอบให้แน่ใจว่า PERPLEXITY_API_KEY ตั้งค่าอย่างถูกต้อง
• ข้อผิดพลาดการเชื่อมต่อ: ตรวจสอบการเชื่อมต่ออินเทอร์เน็ตและความถูกต้องของคีย์ API
• ไม่พบเครื่องมือ: ตรวจสอบให้แน่ใจว่าติดตั้งแพ็คเกจแล้วและเส้นทางคำสั่งถูกต้อง
• ข้อผิดพลาดหมดเวลา: สำหรับคำค้นหาวิจัยที่ยาวมาก ให้ตั้งค่า PERPLEXITY_TIMEOUT_MS เป็นค่าที่สูงขึ้น
• ปัญหาพร็อกซี: ตรวจสอบการตั้งค่า PERPLEXITY_PROXY หรือ HTTPS_PROXY ของคุณและตรวจสอบให้แน่ใจว่า api.perplexity.ai ไม่ถูกบล็อกโดยไฟร์วอลล์ของคุณ
• ข้อผิดพลาด EOF / Initialize: ไคลเอนต์ MCP ที่เข้มงวดบางตัวล้มเหลวเนื่องจาก npx เขียนข้อความการติดตั้งไปยัง stdout ใช้ npx -yq แทน npx -y เพื่อระงับเอาต์พุตนี้

สำหรับการสนับสนุน เยี่ยมชม community.perplexity.ai หรือ รายงานปัญหา

---