Perplexity Ask MCP Server

Perplexity API Platform MCP Server

     

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

เครื่องมือที่พร้อมใช้งาน

perplexity_search

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

perplexity_ask

AI สนทนาอเนกประสงค์พร้อมการค้นหาเว็บแบบเรียลไทม์โดยใช้โมเดล sonar-pro เหมาะสำหรับคำถามสั้นๆ และการค้นหาทั่วไป

perplexity_research

การวิจัยเชิงลึกและครอบคลุมโดยใช้โมเดล sonar-deep-research เหมาะสำหรับการวิเคราะห์อย่างละเอียดและรายงานโดยละเอียด

perplexity_reason

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

[!TIP] มีให้เลือกเป็นพารามิเตอร์เสริมสำหรับ perplexity_reason และ perplexity_research: strip_thinking

ตั้งค่าเป็น true เพื่อลบแท็ก <think>...</think> ออกจากการตอบกลับ ช่วยประหยัดโทเค็นบริบท ค่าเริ่มต้น: false

การกำหนดค่า

รับ API Key ของคุณ

1. รับ Perplexity API Key ของคุณจาก API Portal
2. แทนที่ your_key_here ในการกำหนดค่าด้านล่างด้วย API key ของคุณ
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

Cursor, Claude Desktop, Kiro, Windsurf และ VS Code

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

สำหรับการตั้งค่าด้วยตนเอง ไคลเอนต์เหล่านี้ทั้งหมดใช้โครงสร้าง 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. รับรายละเอียดพร็อกซีของคุณ

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

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	Perplexity API key ของคุณ	จำเป็น
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

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

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

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

---