ResearchMCP

A Model Completion Protocol (MCP) service for internet research using Perplexity AI.

Overview

ResearchMCP is a service that provides internet research capabilities through the MCP protocol. It exposes a "research" tool that allows querying Perplexity AI's API for in-depth, up-to-date information on a wide range of topics.

Features

Internet research through Perplexity AI
Integration with MCP protocol for tool discovery and invocation
Graceful error handling with degraded mode
Configurable through environment variables
Structured logging

Requirements

Go 1.18 or later
Perplexity AI API key

Configuration

The service is configured through environment variables:

Variable	Description	Required	Default
PERPLEXITY_API_KEY	API key for Perplexity AI	Yes	-
PERPLEXITY_MODEL	Model to use for research	No	sonar-medium-online
PERPLEXITY_TIMEOUT	Timeout in seconds for API requests	No	90
PERPLEXITY_MAX_RETRIES	Maximum number of retry attempts	No	2
PERPLEXITY_INITIAL_BACKOFF	Initial backoff time in seconds	No	1
PERPLEXITY_MAX_BACKOFF	Maximum backoff time in seconds	No	10

Usage

Set up the required environment variables (you can use a .env file)
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

API

Research Tool

Name: research

Input Schema:

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The 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"
    }
  ]
}

Development

Project Structure

main.go: Application entry point
config.go: Configuration handling
logger.go: Logging infrastructure
perplexity.go: Perplexity API integration
structs.go: Data structures
context.go: Context handling

Code Style

Run formatting and linting with the provided scripts:

./run_format.sh
./run_lint.sh

License

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

Perplexity Research