[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-73906":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":27,"readmeContent":28,"aiSummary":29,"trendingCount":16,"starSnapshotCount":16,"syncStatus":30,"lastSyncTime":31,"discoverSource":32},73906,"modelcontextprotocol","perplexityai\u002Fmodelcontextprotocol","perplexityai","The official MCP server implementation for the Perplexity API Platform","https:\u002F\u002Fdocs.perplexity.ai\u002Fguides\u002Fmcp-server",null,"TypeScript",2290,340,21,4,0,12,37,107,36,29.6,"MIT License",false,"main",true,[],"2026-06-12 02:03:19","# Perplexity API Platform MCP Server\n\n[![Install in Cursor](https:\u002F\u002Fcustom-icon-badges.demolab.com\u002Fbadge\u002FInstall_in_Cursor-000000?style=for-the-badge&logo=cursor-ai-white)](https:\u002F\u002Fcursor.com\u002Fen\u002Finstall-mcp?name=perplexity&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBwZXJwbGV4aXR5LWFpL21jcC1zZXJ2ZXIiXSwiZW52Ijp7IlBFUlBMRVhJVFlfQVBJX0tFWSI6IiJ9fQ==)\n \n[![Install in VS Code](https:\u002F\u002Fcustom-icon-badges.demolab.com\u002Fbadge\u002FInstall_in_VS_Code-007ACC?style=for-the-badge&logo=vsc&logoColor=white)](https:\u002F\u002Fvscode.dev\u002Fredirect\u002Fmcp\u002Finstall?name=perplexity&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40perplexity-ai%2Fmcp-server%22%5D%2C%22env%22%3A%7B%22PERPLEXITY_API_KEY%22%3A%22%22%7D%7D)\n \n[![Add to Kiro](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FAdd_to_Kiro-9046FF?style=for-the-badge&logo=data:image\u002Fsvg+xml;base64,PHN2ZyB3aWR0aD0iMTkxIiBoZWlnaHQ9IjIyNi44MTQiIHZpZXdCb3g9IjAgMCAxOTEgMjI2LjgxNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj48cGF0aCBkPSJNMzUuNjA5IDE3My4xNjVjLTIzLjExMSA1MS4yMzUgMjYuMTA2IDY0LjA2OCA2Mi4zOTYgMzQuMTA2IDEwLjY2IDMzLjYwNSA1MC42OTggOC41MzQgNjUuMDU5LTE3LjUxMSAzMS42MzQtNTcuMzgzIDE4Ljg2Mi0xMTUuOTM3IDE1LjU3OS0xMjguMDE3LTIyLjUwMi04Mi4zNTctMTM0LjkyOS04Mi40MjktMTU0LjI4MS40MTgtNC41MjMgMTQuNTA1LTQuNTk1IDMxLjAwMy03LjE2MSA0OC4xMzItMS4yOSA4LjYzMS0yLjE5OCAxNC4xNDUtNS41MzkgMjMuMjMtMS45MjEgNS4yMTgtNC41NTkgOS44NDktOC43MTQgMTcuNjY2LTguMjEzIDEyLjU0NS4xNTUgMzguMiAzMi42NSAyMi4wMDF6IiBmaWxsPSIjZmZmIi8+PHBhdGggZD0iTTEwMi42MDMgOTYuODk4Yy05LjIyOSAwLTEwLjYxMy0xMS4wMzEtMTAuNjEzLTE3LjU5NyAwLTUuOTMyIDEuMDc0LTEwLjY0OSAzLjA2Ny0xMy42NDRhOC41OCA4LjU4IDAgMCAxIDcuNTIxLTMuOTY0YzMuMjM2IDAgNi4wMDQgMS4zNjIgNy45NjEgNC4wMzYgMi4yMDkgMy4wNDUgMy4zOTEgNy43NTkgMy4zOTEgMTMuNTg2IDAgMTEuMDE3LTQuMjM4IDE3LjU5Ny0xMS4zNDEgMTcuNTk3em0zNy45NDggMGMtOS4yNCAwLTEwLjYyNC0xMS4wMzEtMTAuNjI0LTE3LjU5NyAwLTUuOTMyIDEuMDc0LTEwLjY0OSAzLjA4MS0xMy42NDRhOC41OCA4LjU4IDAgMCAxIDcuNTIxLTMuOTY0IDkuNTEgOS41MSAwIDAgMSA3Ljk1IDQuMDM2YzIuMjIgMy4wNDUgMy40MDIgNy43NTkgMy40MDIgMTMuNTg2IDAgMTEuMDE3LTQuMjM4IDE3LjU5Ny0xMS4zNDEgMTcuNTk3eiIgZmlsbD0iIzAwMCIvPlw8L3N2Zz4=&logoColor=white)](https:\u002F\u002Fkiro.dev\u002Flaunch\u002Fmcp\u002Fadd?name=perplexity&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40perplexity-ai%2Fmcp-server%22%5D%2C%22env%22%3A%7B%22PERPLEXITY_API_KEY%22%3A%22your_key_here%22%7D%7D)\n \n[![npm version](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F%40perplexity-ai%2Fmcp-server?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@perplexity-ai\u002Fmcp-server)\n\nThe official MCP server implementation for the Perplexity API Platform, providing AI assistants with real-time web search, reasoning, and research capabilities through Sonar models and the Search API.\n\n## Available Tools\n\n### **perplexity_search**\nDirect web search using the Perplexity Search API. Returns ranked search results with metadata, perfect for finding current information.\n\n### **perplexity_ask**\nGeneral-purpose conversational AI with real-time web search using the `sonar-pro` model. Great for quick questions and everyday searches.\n\n### **perplexity_research**\nDeep, comprehensive research using the `sonar-deep-research` model. Ideal for thorough analysis and detailed reports.\n\n### **perplexity_reason**\nAdvanced reasoning and problem-solving using the `sonar-reasoning-pro` model. Perfect for complex analytical tasks.\n\n> [!TIP]\n> Available as an optional parameter for **perplexity_reason** and **perplexity_research**: `strip_thinking`\n>\n> Set to `true` to remove `\u003Cthink>...\u003C\u002Fthink>` tags from the response, saving context tokens. Default: `false`\n\n## Configuration\n\n### Get Your API Key\n\n1. Get your Perplexity API Key from the [API Portal](https:\u002F\u002Fwww.perplexity.ai\u002Faccount\u002Fapi\u002Fgroup)\n2. Replace `your_key_here` in the configurations below with your API key\n3. (Optional) Set timeout: `PERPLEXITY_TIMEOUT_MS=600000` (default: 5 minutes)\n4. (Optional) Set custom base URL: `PERPLEXITY_BASE_URL=https:\u002F\u002Fyour-custom-url.com` (default: https:\u002F\u002Fapi.perplexity.ai)\n5. (Optional) Set log level: `PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR` (default: ERROR)\n\n### Claude Code\n\n```bash\nclaude mcp add perplexity --env PERPLEXITY_API_KEY=\"your_key_here\" -- npx -y @perplexity-ai\u002Fmcp-server\n```\n\nOr install via plugin:\n```bash\nexport PERPLEXITY_API_KEY=\"your_key_here\"\nclaude\n# Then run: \u002Fplugin marketplace add perplexityai\u002Fmodelcontextprotocol\n# Then run: \u002Fplugin install perplexity\n```\n\n### Codex\n\n```bash\ncodex mcp add perplexity --env PERPLEXITY_API_KEY=\"your_key_here\" -- npx -y @perplexity-ai\u002Fmcp-server\n```\n\n### Cursor, Claude Desktop, Kiro, Windsurf, and VS Code\n\nMost clients can be configured manually using the same `mcpServers` wrapper in their client config (as shown for Cursor). If a client has a different schema, check its docs for the exact wrapper format.\n\nFor manual setup, these clients all use the same `mcpServers` structure:\n\n| Client | Config File |\n|--------|-------------|\n| Cursor | `~\u002F.cursor\u002Fmcp.json` |\n| Claude Desktop | `claude_desktop_config.json` |\n| Kiro | `.kiro\u002Fsettings\u002Fmcp.json` |\n| Windsurf | `~\u002F.codeium\u002Fwindsurf\u002Fmcp_config.json` |\n| VS Code | `.vscode\u002Fmcp.json` |\n\n```json\n{\n  \"mcpServers\": {\n    \"perplexity\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@perplexity-ai\u002Fmcp-server\"],\n      \"env\": {\n        \"PERPLEXITY_API_KEY\": \"your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Proxy Setup (For Corporate Networks)\n\nIf you are running this server at work—especially behind a company firewall or proxy—you may need to tell the program how to send its internet traffic through your network's proxy. Follow these steps:\n\n**1. Get your proxy details**\n\n- Ask your IT department for your HTTPS proxy address and port.\n- You may also need a username and password.\n\n**2. Set the proxy environment variable**\n\nThe easiest and most reliable way for Perplexity MCP is to use `PERPLEXITY_PROXY`. For example:\n\n```bash\nexport PERPLEXITY_PROXY=https:\u002F\u002Fyour-proxy-host:8080\n```\n\nIf your proxy needs a username and password, use:\n\n```bash\nexport PERPLEXITY_PROXY=https:\u002F\u002Fusername:password@your-proxy-host:8080\n```\n\n**3. Alternate: Standard environment variables**\n\nIf you'd rather use the standard variables, we support `HTTPS_PROXY` and `HTTP_PROXY`.\n\n> [!NOTE]\n> The server checks proxy settings in this order: `PERPLEXITY_PROXY` → `HTTPS_PROXY` → `HTTP_PROXY`. If none are set, it connects directly to the internet.\n> URLs must include `https:\u002F\u002F`. Typical ports are `8080`, `3128`, and `80`.\n\n### HTTP Server Deployment\n\nFor cloud or shared deployments, run the server in HTTP mode.\n\n#### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `PERPLEXITY_API_KEY` | Your Perplexity API key | *Required* |\n| `PERPLEXITY_BASE_URL` | Custom base URL for API requests | `https:\u002F\u002Fapi.perplexity.ai` |\n| `PORT` | HTTP server port | `8080` |\n| `BIND_ADDRESS` | Network interface to bind to | `0.0.0.0` |\n| `ALLOWED_ORIGINS` | CORS origins (comma-separated) | `*` |\n\n#### Docker\n\n```bash\ndocker build -t perplexity-mcp-server .\ndocker run -p 8080:8080 -e PERPLEXITY_API_KEY=your_key_here perplexity-mcp-server\n```\n\n#### Node.js\n\n```bash\nexport PERPLEXITY_API_KEY=your_key_here\nnpm install && npm run build && npm run start:http\n```\n\nThe server will be accessible at `http:\u002F\u002Flocalhost:8080\u002Fmcp`\n\n## Troubleshooting\n\n- **API Key Issues**: Ensure `PERPLEXITY_API_KEY` is set correctly\n- **Connection Errors**: Check your internet connection and API key validity\n- **Tool Not Found**: Make sure the package is installed and the command path is correct\n- **Timeout Errors**: For very long research queries, set `PERPLEXITY_TIMEOUT_MS` to a higher value\n- **Proxy Issues**: Verify your `PERPLEXITY_PROXY` or `HTTPS_PROXY` setup and ensure `api.perplexity.ai` isn't blocked by your firewall.\n- **EOF \u002F Initialize Errors**: Some strict MCP clients fail because `npx` writes installation messages to stdout. Use `npx -yq` instead of `npx -y` to suppress this output.\n\nFor support, visit [community.perplexity.ai](https:\u002F\u002Fcommunity.perplexity.ai) or [file an issue](https:\u002F\u002Fgithub.com\u002Fperplexityai\u002Fmodelcontextprotocol\u002Fissues).\n\n---\n","perplexityai\u002Fmodelcontextprotocol 是 Perplexity API 平台的官方 MCP 服务器实现，采用 TypeScript 编写。该项目通过 Sonar 模型和 Search API 为 AI 助手提供实时网络搜索、推理和研究功能。其核心工具包括 perplexity_search 和 perplexity_ask：前者能够直接利用 Perplexity Search API 进行网页搜索并返回带有元数据的排序结果，适用于需要获取最新信息的场景；后者则支持通用对话交互。该服务器特别适合于开发集成有高级搜索和自然语言处理能力的应用程序。",2,"2026-06-11 03:47:51","high_star"]