[{"_1":2,"_305":-5,"_306":-5},"loaderData",{"_3":4,"_20":21,"_22":23,"_24":25,"_240":241},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":-5,"_17":18,"_19":-5},"attributes",[15],"BOT","membership","uid","9IfdRPWl9k","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":-5,"_27":28,"_29":30,"_159":160},"githubUser","maintainer",false,"mcpServer",{"_31":32,"_33":34,"_13":54,"_61":62,"_63":62,"_64":65,"_70":71,"_92":-5,"_93":94,"_95":28,"_96":97,"_80":129,"_130":85,"_131":-5,"_132":-5,"_133":-5,"_134":135,"_142":-5,"_143":144,"_149":-5,"_104":81,"_150":151,"_155":-5,"_17":156,"_157":158},"addedAt",["D",1742555877909],"argumentsJsonSchema",{"_35":36,"_44":45,"_49":53},"oneOf",[37,41],{"_38":39},"required",[40],"OPENROUTER_API_KEY",{"_38":42},[43],"PERPLEXITY_API_KEY","properties",{"_40":46,"_43":51},{"_47":48,"_49":50},"description","Your OpenRouter API key","type","string",{"_47":52,"_49":50},"Your Perplexity API key","object",[55,56,57,58,59,60],"category:search","category:browser-automation","author:claimed","hosting:remote-capable","language:python","license_grade:f","descriptionMarkdown","An advanced integration package that leverages OpenRouter and Perplexity APIs to provide enhanced web search capabilities, offering both simple and complex query processing with file attachment support.","descriptionPlainText","githubProject",{"_66":67,"_68":69},"readme","

\n\n# Perplexity Advanced MCP\n\n[![GitHub](https://img.shields.io/badge/GitHub-100000?style=for-the-badge&logo=github&logoColor=white)](https://github.com/code-yeongyu/perplexity-advanced-mcp)\n[![PyPI](https://img.shields.io/badge/pypi-3775A9?style=for-the-badge&logo=pypi&logoColor=white)](https://pypi.org/project/perplexity-advanced-mcp)\n[![smithery badge](https://smithery.ai/badge/@code-yeongyu/perplexity-advanced-mcp)](https://smithery.ai/server/@code-yeongyu/perplexity-advanced-mcp)\n\n[한국어](README-ko.md)\n\n

\n\n---\n\n## Overview\n\nPerplexity Advanced MCP is an advanced integration package that leverages the [OpenRouter](https://openrouter.ai/) and [Perplexity](https://docs.perplexity.ai/home) APIs to provide enhanced query processing capabilities. With an intuitive command-line interface and a robust API client, this package facilitates seamless interactions with AI models for both simple and complex queries.\n\n## Comparison with [perplexity-mcp](https://github.com/jsonallen/perplexity-mcp)\n\nWhile [perplexity-mcp](https://github.com/jsonallen/perplexity-mcp) provides basic web search functionality using [Perplexity](https://docs.perplexity.ai/home) AI's API, Perplexity Advanced MCP offers several additional features:\n\n- **Multi-vendor Support:** Supports both [Perplexity](https://docs.perplexity.ai/home) and [OpenRouter](https://openrouter.ai/) APIs, giving you flexibility in choosing your provider\n- **Query Type Optimization:** Distinguishes between simple and complex queries, optimizing for cost and performance\n- **File Attachment Support:** Allows including file contents as context in your queries, enabling more precise and contextual responses\n- **Enhanced Retry Logic:** Implements robust retry mechanisms for improved reliability\n\nOverall, this is the most suitable MCP for handling codebases when integrated with editors like [Cline](https://cline.bot/) or [Cursor](https://www.cursor.com/).\n\n\n## Features\n\n- **Unified API Client:** Supports both [OpenRouter](https://openrouter.ai/) and [Perplexity](https://docs.perplexity.ai/home) APIs with configurable models for handling simple and complex queries.\n- **Command-Line Interface (CLI):** Manage API key configuration and run the MCP server using [Typer](https://typer.tiangolo.com/).\n- **Advanced Query Processing:** Incorporates file attachment processing, allowing you to include contextual data in your queries.\n- **Robust Retry Mechanism:** Utilizes Tenacity for retry logic to ensure consistent and reliable API communications.\n- **Customizable Logging:** Flexible logging configuration for detailed debugging and runtime monitoring.\n\n## Optimal AI Configuration\n\nFor the best experience with AI assistants (e.g., [Cursor](https://www.cursor.com/), [Claude for Desktop](https://claude.ai/download)), I recommend adding the following configuration to your project instructions or AI rules:\n\n```xml\n\n \n Perplexity is an LLM that can search the internet, gather information, and answer users' queries.\n\n For example, let's suppose we want to find out the latest version of Python.\n 1. You would search on Google.\n 2. Then read the top two or three results directly to verify.\n\n Perplexity does that work for you.\n\n To answer a user's query, Perplexity searches, opens the top search results, finds information on those websites, and then provides the answer.\n\n Perplexity can be used with two types of queries: simple and complex. Choosing the right query type to fulfill the user's request is most important.\n \n \n \n It's cheap and fast. However, it's not suitable for complex queries. On average, it's more than 10 times cheaper and 3 times faster than complex queries.\n Use it for simple questions such as \"What is the latest version of Python?\"\n \n \n $1/M input tokens\n $1/M output tokens\n \n \n\n \n \n It's slower and more expensive. Compared to simple queries, it's on average more than 10 times more expensive and 3 times slower.\n Use it for more complex requests like \"Analyze the attached code to examine the current status of a specific library and create a migration plan.\"\n \n \n $1/M input tokens\n $5/M output tokens\n \n \n\n \n When reviewing the user's request, if you find anything unexpected, uncertain, or questionable, **and you think you can get answer from the internet**, do not hesitate to use the \"ask_perplexity\" tool to consult Perplexity. However, if the internet is not required to satisfy users' request, it's meaningless to ask to perplexity.\n Since Perplexity is also an LLM, prompt engineering techniques are paramount.\n Remember the basics of prompt engineering, such as providing clear instructions, sufficient context, and examples\n Include as much context and relevant files as possible to smoothly fulfill the user's request. When adding files as attachments, make sure they are absolute paths.\n \n\n```\n\nThis configuration helps AI assistants better understand when and how to use the Perplexity search functionality, optimizing for both cost and performance.\n\n## Usage\n\n### Installing via Smithery\n\nTo install Perplexity Advanced MCP for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@code-yeongyu/perplexity-advanced-mcp):\n\n```bash\nnpx -y @smithery/cli install @code-yeongyu/perplexity-advanced-mcp --client claude\n```\n\n### Quick Start with [uvx](https://docs.astral.sh/uv/guides/tools/)\n\nThe easiest way to run the MCP server is using [uvx](https://docs.astral.sh/uv/guides/tools/):\n\n```sh\nuvx perplexity-advanced-mcp -o # or -p \n```\n\nYou can also configure the API keys using environment variables:\n\n```sh\nexport OPENROUTER_API_KEY=\"your_key_here\"\n# or\nexport PERPLEXITY_API_KEY=\"your_key_here\"\n\nuvx perplexity-advanced-mcp\n```\n\nNote:\n- Providing both OpenRouter and Perplexity API keys simultaneously will result in an error\n- When both CLI arguments and environment variables are provided, CLI arguments take precedence\n\nThe CLI is built with [Typer](https://typer.tiangolo.com/), ensuring a user-friendly command-line experience.\n\n### MCP Search Tool\n\nThe package includes an MCP search tool integrated via the `ask_perplexity` function. It supports both simple and complex queries and processes file attachments to provide additional context.\n\n- **Simple Queries:** Provides fast, efficient responses.\n- **Complex Queries:** Engages in detailed reasoning and supports file attachments formatted as XML.\n\n## Configuration\n\n- **API Keys:** Configure either the `OPENROUTER_API_KEY` or `PERPLEXITY_API_KEY` through command-line options or environment variables.\n- **Model Selection:** The configuration (in `src/perplexity_advanced_mcp/config.py`) maps query types to specific models:\n - **[OpenRouter](https://openrouter.ai/):**\n - Simple Queries: `perplexity/sonar`\n - Complex Queries: `perplexity/sonar-reasoning`\n - **[Perplexity](https://docs.perplexity.ai/home):**\n - Simple Queries: `sonar-pro`\n - Complex Queries: `sonar-reasoning-pro`\n\n## Development Background & Philosophy\n\nThis project emerged from my personal curiosity and experimentation. Following the recent [\"vibe coding\"](https://x.com/karpathy/status/1886192184808149383) trend, over 95% of the code was written through [Cline](https://cline.bot/) + [Cursor](https://www.cursor.com/) IDE. They say \"talk is cheap, show me the code\" - well, with [Wispr Flow](https://wisprflow.ai/)'s speech-to-text magic, I literally just talked and the code showed up! Most of the development was done by me saying things like \"Write me the code for x y z, fix the bug here x y z.\" and pressing enter. Remarkably, creating this fully functional project took less than a few hours.\n\nFrom project scaffolding to file structure, everything was written and reviewed through LLM. Even the GitHub Actions workflow for PyPI publishing and the release approval process were handled through Cursor. As a human developer, my role was to:\n\n- Starting and stopping the MCP server to help AI conduct proper testing\n- Copying and providing error logs when issues occurred\n- Finding and providing [Python MCP SDK](https://github.com/modelcontextprotocol/python-sdk) documentation and examples from the internet\n- Requesting modifications for code that didn't seem correct\n\nIn today's world where many things can be automated and replaced, I hope this MCP can help developers like you who use it to discover value beyond just writing code. May this tool assist you in becoming a new era developer who can make higher-level decisions and considerations.\n\n## Development\n\nTo contribute or modify this package:\n\n### 1. **Clone the Repository:**\n\n```sh\ngh repo clone code-yeongyu/perplexity-advanced-mcp\n```\n\n### 2. **Install Dependencies:**\n\n```sh\nuv sync\n```\n\n### 3. **Contribute:**\n\nContributions are welcome! Please follow the existing code style and commit guidelines.\n\n## License\n\nThis project is licensed under the MIT License.\n","url","https://github.com/code-yeongyu/perplexity-advanced-mcp","githubRepository",{"_72":73,"_74":75,"_76":77,"_78":79,"_80":81,"_82":83,"_87":88,"_89":-5,"_90":91},"defaultBranch","master","fullName","code-yeongyu/perplexity-advanced-mcp","githubTreeId",97346,"language","Python","name","perplexity-advanced-mcp","owner",{"_84":85,"_17":86},"login","code-yeongyu","eW25BmCIHe","recentStargazers",3,"spdxLicense","stargazers",18,"glamaJson","id",2370,"inspectable","integrations",[98,108,115,122],{"_99":100,"_47":106,"_17":107},"brand",{"_101":102,"_80":103,"_104":105},"logoSvgPath","M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12","GitHub","slug","github","Provides integration with GitHub for source code hosting and version control.","t57sdw9k8y",{"_99":109,"_47":113,"_17":114},{"_101":110,"_80":111,"_104":112},"M22.3977 7.0896h-2.3106V.0676l-7.5094 6.3542V.1577h-1.1554v6.1966L4.4904 0v7.0896H1.6023v10.3976h2.8882V24l6.932-6.3591v6.2005h1.1554v-6.0469l6.9318 6.1807v-6.4879h2.8882V7.0896zm-3.4657-4.531v4.531h-5.355l5.355-4.531zm-13.2862.0676 4.8691 4.4634H5.6458V2.6262zM2.7576 16.332V8.245h7.8476l-6.1149 6.1147v1.9723H2.7576zm2.8882 5.0404v-3.8852h.0001v-2.6488l5.7763-5.7764v7.0111l-5.7764 5.2993zm12.7086.0248-5.7766-5.1509V9.0618l5.7766 5.7766v6.5588zm2.8882-5.0652h-1.733v-1.9723L13.3948 8.245h7.8478v8.087z","Perplexity","perplexity","Provides a tool for asking internet search queries through Perplexity AI, supporting both simple and complex queries with file attachment capabilities. Optimized for different query types to balance cost and performance.","2cn99jeh3l",{"_99":116,"_47":120,"_17":121},{"_101":117,"_80":118,"_104":119},"M23.922 13.58v3.912L20.55 18.72l-.078.055.052.037 3.45-1.256.026-.036v-3.997l-.053-.036-.025.092z M23.621 5.618l-3.04 1.107v3.912l3.339-1.215V5.509zM23.92 13.457V9.544l-3.336 1.215v3.913zM20.47 14.71V10.8L17.17 12v3.913zM17.034 19.996v-3.912l-3.313 1.206v3.912zM17.17 16.057v3.868l3.314-1.206V14.85l-3.314 1.206zm2.093 1.882c-.367.134-.663-.074-.663-.463s.296-.814.663-.947c.365-.133.662.075.662.464s-.297.814-.662.946z M13.225 9.315l.365-.132-3.285-1.197-3.323 1.21.102.037 3.184 1.16zM20.507 10.664V6.751L17.17 7.965v3.913zM17.058 11.918V8.005l-3.302 1.202v3.912zM13.643 9.246l-3.336 1.215v3.913l3.336-1.215zM6.907 13.165l3.322 1.209v-3.913L6.907 9.252z M10.34 7.873l3.281 1.193V5.198l-3.28-1.193zM20.507 2.715L17.19 3.922v3.913l3.317-1.207zM16.95 3.903L13.724 2.73l-3.269 1.19 3.225 1.174zM15.365 4.606l-1.624.592v3.868l3.317-1.207V3.991l-1.693.615zm-.391 2.778c-.367.134-.662-.074-.662-.464s.295-.813.662-.946c.366-.133.663.074.663.464s-.297.813-.663.946z M10.229 18.41v-3.914l-3.322-1.209V17.2zM13.678 17.182v-3.913l-3.371 1.227v3.913z M13.756 17.154l3.3-1.2V12.04l-3.3 1.2zM13.678 21.217l-3.371 1.227v-3.912h-.078v3.912l-3.322-1.209v-3.913l-.053-.058-.025-.06-3.336-1.21v-3.948l.034.013 3.287 1.196.015-.078-3.261-1.187 3.26-1.187v-.109L3.876 9.62l-.307-.112 3.26-1.188v.877l.079-.055V6.769l3.257 1.185.058-.061L7.084 6.75l-.102-.037 3.24-1.179v-.083L6.854 6.677v.018l-.025.018v1.523L3.44 9.47v.02l-.025.017v4.007l-3.39 1.233v.019L0 14.784v3.995l.025.037 3.4 1.237.008-.006.007.01 3.4 1.238.008-.006.006.01 3.4 1.237.014-.009.012.01 3.45-1.256.026-.037-.078-.027zM3.493 9.563l3.257 1.185-3.257 1.187V9.562zM3.4 19.96L.078 18.752v-3.913l2.361.86.96.349v3.913zm.015-3.99L.335 14.85l-.182-.066 3.262-1.187v2.374zm3.399 5.231l-3.321-1.209v-3.912l3.321 1.209v3.912zM23.791 5.434l-3.21-1.17v2.338zM20.387 2.643l-3.24-1.18-3.27 1.19 3.247 1.182z","PyPI","pypi","Enables distribution of the package through the Python Package Index, allowing users to install the MCP via pip or uvx.","dc3dyquaaa",{"_99":123,"_47":127,"_17":128},{"_101":124,"_80":125,"_104":126},"M21.818 3.646H2.182C.982 3.646 0 4.483 0 5.505v3.707h2.182V5.486h19.636v13.036H2.182v-3.735H0v3.726c0 1.022.982 1.84 2.182 1.84h19.636c1.2 0 2.182-.818 2.182-1.84V5.505c0-1.032-.982-1.859-2.182-1.859Zm-10.909 12.07L15.273 12l-4.364-3.717v2.787H0v1.859h10.909v2.787Z","Typer","typer","Implements a command-line interface using Typer for managing API key configuration and running the MCP server.","w3iqwiiqjj","Perplexity Advanced MCP","namespace","npmPackage","prompts","redditPostForeignId","relatedMcpServerIds",[136,137,138,139,140,141],873,472,1597,944,912,875,"resources","scores",{"_145":146,"_147":-5,"_148":-5},"license",0,"quality","security","simpleIcon","supportedPlatforms",[152,153,154],"WINDOWS","LINUX","MACOS","tools","sok882f31z","updatedAt",["D",1742581156731],"meta",[161,164,166,173,176,178,181,184,187,190,193,195,198,201,203,205,207,209,211],{"_162":163},"title","Perplexity Advanced MCP | Glama",{"_165":62,"_80":47},"content",{"_167":168,"_169":170,"_171":172},"href","https://glama.ai/mcp/servers/@code-yeongyu/perplexity-advanced-mcp","rel","canonical","tagName","link",{"_165":129,"_174":175},"property","og:title",{"_165":62,"_174":177},"og:description",{"_165":179,"_174":180},"https://glama.ai/logo.png","og:logo",{"_165":182,"_174":183},"https://glama.ai/mcp/servers/@code-yeongyu/perplexity-advanced-mcp/og-image","og:image",{"_165":185,"_174":186},"630","og:image:height",{"_165":188,"_174":189},"1200","og:image:width",{"_165":191,"_174":192},"website","og:type",{"_165":168,"_174":194},"og:url",{"_165":196,"_174":197},"ChatGPT alternative for power users","og:site_name",{"_165":199,"_80":200},"summary_large_image","twitter:card",{"_165":196,"_80":202},"twitter:title",{"_165":62,"_80":204},"twitter:description",{"_165":182,"_80":206},"twitter:image",{"_165":185,"_80":208},"twitter:image:height",{"_165":188,"_80":210},"twitter:image:width",{"_212":213},"script:ld+json",{"_214":215,"_216":217},"@context","http://schema.org","@graph",[218],{"_214":219,"_220":221,"_222":223},"https://schema.org","@type","BreadcrumbList","itemListElement",[224,231,235,238],{"_220":225,"_226":227,"_80":228,"_229":230},"ListItem","item","https://glama.ai/","Glama","position",1,{"_220":225,"_226":232,"_80":233,"_229":234},"https://glama.ai/mcp","MCP",2,{"_220":225,"_226":236,"_80":237,"_229":88},"https://glama.ai/mcp/servers","Servers",{"_220":225,"_226":168,"_80":129,"_229":239},4,"routes/_public/mcp/servers/~namespace/~slug/_pages/reviews/_route",{"_26":-5,"_29":242,"_159":270,"_304":-5},{"_31":243,"_33":244,"_13":253,"_61":62,"_63":62,"_64":254,"_70":255,"_92":-5,"_93":94,"_95":28,"_96":257,"_80":129,"_130":85,"_131":-5,"_132":-5,"_133":-5,"_134":266,"_142":-5,"_143":267,"_149":-5,"_104":81,"_150":268,"_155":-5,"_17":156,"_157":269},["D",1742555877909],{"_35":245,"_44":250,"_49":53},[246,248],{"_38":247},[40],{"_38":249},[43],{"_40":251,"_43":252},{"_47":48,"_49":50},{"_47":52,"_49":50},[55,56,57,58,59,60],{"_66":67,"_68":69},{"_72":73,"_74":75,"_76":77,"_78":79,"_80":81,"_82":256,"_87":88,"_89":-5,"_90":91},{"_84":85,"_17":86},[258,260,262,264],{"_99":259,"_47":106,"_17":107},{"_101":102,"_80":103,"_104":105},{"_99":261,"_47":113,"_17":114},{"_101":110,"_80":111,"_104":112},{"_99":263,"_47":120,"_17":121},{"_101":117,"_80":118,"_104":119},{"_99":265,"_47":127,"_17":128},{"_101":124,"_80":125,"_104":126},[136,137,138,139,140,141],{"_145":146,"_147":-5,"_148":-5},[152,153,154],["D",1742581156731],[271,273,274,276,278,279,280,281,282,283,284,285,286,287,288,289,290,291,292],{"_162":272},"Reviews | Perplexity Advanced MCP | Glama",{"_165":62,"_80":47},{"_167":275,"_169":170,"_171":172},"https://glama.ai/mcp/servers/@code-yeongyu/perplexity-advanced-mcp/reviews",{"_165":277,"_174":175},"Reviews | Perplexity Advanced MCP",{"_165":62,"_174":177},{"_165":179,"_174":180},{"_165":182,"_174":183},{"_165":185,"_174":186},{"_165":188,"_174":189},{"_165":191,"_174":192},{"_165":275,"_174":194},{"_165":196,"_174":197},{"_165":199,"_80":200},{"_165":196,"_80":202},{"_165":62,"_80":204},{"_165":182,"_80":206},{"_165":185,"_80":208},{"_165":188,"_80":210},{"_212":293},{"_214":215,"_216":294},[295],{"_214":219,"_220":221,"_222":296},[297,298,299,300,301],{"_220":225,"_226":227,"_80":228,"_229":230},{"_220":225,"_226":232,"_80":233,"_229":234},{"_220":225,"_226":236,"_80":237,"_229":88},{"_220":225,"_226":168,"_80":129,"_229":239},{"_220":225,"_226":275,"_80":302,"_229":303},"Reviews",5,"review","actionData","errors"]

Rate & Review