what is Perplexity AI MCP Server?
Perplexity AI MCP Server is an implementation that integrates Perplexity AI's API, providing advanced search capabilities with multiple model options.
how to use Perplexity AI MCP Server?
To use the server, install the necessary packages, configure your API key, and execute the server using Node.js.
key features of Perplexity AI MCP Server?
- Search using Perplexity AI's models
- Support for all official Sonar models
- Configurable result count
- Detailed error handling and logging
- MCP Inspector compatible
use cases of Perplexity AI MCP Server?
- Performing advanced searches using AI models.
- Integrating with applications that require intelligent search capabilities.
- Analyzing search results with detailed logging and error handling.
FAQ from Perplexity AI MCP Server?
- What models are supported?
The server supports multiple models including sonar-reasoning-pro, sonar-reasoning, sonar-pro, and sonar.
- How do I configure the API key?
Sign up for a Perplexity AI account, obtain your API key, and set it as an environment variable.
- Is there a logging feature?
Yes, logs are written to
perplexity-mcp.login the project root directory.
Perplexity AI MCP Server
An MCP server implementation that integrates Perplexity AI's API, providing advanced search capabilities with multiple model options.
Features
- Search using Perplexity AI's models
- Support for all official Sonar models
- Configurable result count
- Detailed error handling and logging
- MCP Inspector compatible
Available Models
- sonar-reasoning-pro (127k context)
- sonar-reasoning (127k context)
- sonar-pro (200k context)
- sonar (127k context)
Installation
pnpm install
pnpm build
Configuration
API Key
- Sign up for a Perplexity AI account
- Get your API key from the dashboard
- Set the environment variable:
export PERPLEXITY_API_KEY=your_api_key_here
Usage
Direct Execution
node dist/index.js
# or if you made it executable
./dist/index.js
Development
pnpm dev
Testing with MCP Inspector
pnpm inspect
Tool Reference
perplexity_search
Performs a search using Perplexity AI's models.
Parameters:
query(string, required): The search querymodel(string, optional): Model to use (default: "sonar")- Available options: sonar-reasoning-pro, sonar-reasoning, sonar-pro, sonar
count(number, optional): Number of results (1-10, default: 5)
Development
Project Structure
src/perplexity/
├── index.ts # Main server implementation
├── lib/
│ └── logger.ts # Logging configuration
└── adr.md # Architectural decisions
Logging
Logs are written to perplexity-mcp.log in the project root directory.
License
MIT
Contributing
- Fork the repository
- Create your feature branch
- Commit your changes
- Push to the branch
- Create a new Pull Request
