Perplexity MCP Server

🚀 Perplexity MCP Server

This is a simple MCP server that allows you to use Perplexity AI to search the internet.

🚀 Quick Start

Prerequisites

• Node.js 18+ (Download from nodejs.org)
• Git (Download from git-scm.com)
• Perplexity AI API key

Steps on Windows

1. Clone the repository:

git clone [repository-url]
cd perplexity-mcp-server

2. Install dependencies:

npm install

3. Create an environment file:
   • Create a new file .env in the root directory.
   • Add your Perplexity AI API key:

   PERPLEXITY_API_KEY=your_api_key_here
   

💻 Usage Examples

Development Mode

npm run dev

Production Mode

1. Build the project:

npm run build

2. Start the server:

npm start

Using the Windows Batch File (Recommended)

To avoid environment variable issues on Windows, use the provided batch file:

1. First, build the project:

npm run build

2. Run the batch file:

.\run-perplexity-server.bat

Or double - click the run-perplexity-server.bat file in Windows Explorer.

For detailed instructions, refer to the Windows Installation Guide.

📚 Documentation

Troubleshooting on Windows

Common Issues

1. Permission Errors

   • Run the Command Prompt or PowerShell as an administrator.
   • Check the file permissions in the project directory.

2. Environment Variables

   • Ensure the .env file is in the root directory.
   • There should be no spaces around the equal sign = in the .env file.
   • Restart the terminal after modifying the environment variables.
   • Use the provided batch file to avoid environment variable issues.

3. Node.js Issues

   • Verify the Node.js installation: node --version
   • Ensure npm is installed: npm --version

Error Messages

If you see Error: ENOENT: no such file or directory, make sure:

• All paths use the correct Windows-style separators.
• You are in the correct directory.
• The necessary files exist.

Project Structure

perplexity-mcp-server/
├── src/
│   └── index.ts          # Main server implementation
├── dist/                 # Compiled output
├── .env                  # Environment variables
├── package.json          # Project configuration
├── run-perplexity-server.bat # Windows batch file
└── tsconfig.json         # TypeScript configuration

API Usage

The server provides a tool perplexity_search for web searches:

{
  "name": "perplexity_search",
  "arguments": {
    "query": "your search query here"
  }
}

📄 License

MIT