Perplexity Research

🚀 Research MCP

A Model Completion Protocol (MCP) for internet research services powered by Perplexity AI.

🚀 Quick Start

Research MCP is a service that offers internet research capabilities. It exposes a "research" tool through the MCP protocol. This tool enables users to obtain in - depth and up - to - date information on various topics by querying the Perplexity AI API.

✨ Features

• Conduct internet research via Perplexity AI.
• Integrate the MCP protocol for tool discovery and invocation.
• Implement graceful error handling with a fallback mode.
• Configure through environment variables.
• Provide structured logging.

📦 Installation

Requirements

• Go 1.18 or higher.
• Perplexity AI API key.

Configuration

The service is configured using environment variables:

Steps

1. Set the required environment variables (you can use a .env file).
2. Build and run the service:

go build
./ResearchMCP

Example .env file

PERPLEXITY_API_KEY=your_api_key_here
PERPLEXITY_MODEL=sonar-medium-online
PERPLEXITY_TIMEOUT=120
PERPLEXITY_MAX_RETRIES=3
PERPLEXITY_INITIAL_BACKOFF=2
PERPLEXITY_MAX_BACKOFF=15

💻 Usage Examples

Basic Usage

The following shows how to use the research tool.

Input schema:

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Research query or question"
    }
  },
  "required": ["query"]
}

Example request:

{
  "name": "research",
  "arguments": {
    "query": "What is the current state of quantum computing?"
  }
}

Example response:

{
  "content": [
    {
      "type": "text",
      "text": "Comprehensive research report on quantum computing...\n\nSources:\n- https://example.com/source1\n- https://example.com/source2"
    }
  ]
}

📚 Documentation

Project Structure

• main.go: Entry point of the application.
• config.go: Configuration handling.
• logger.go: Logging infrastructure.
• perplexity.go: Perplexity API integration.
• structs.go: Data structures.
• context.go: Context handling.

Code Style

Use the provided scripts to run formatting and checks:

./run_format.sh
./run_lint.sh

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.