Researchmcp

🚀 Research MCP

A web research service using Perplexity AI, providing Model Completion Protocol (MCP).

🚀 Quick Start

Research MCP is a service that offers internet research capabilities through the MCP protocol. It exposes a "research" tool, allowing 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.
• Feature elegant error handling and degradation modes.
• Configure through environment variables.
• Implement structured logging.

📦 Installation

Requirements

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

Configuration

The service is configured through environment variables:

💻 Usage Examples

Basic Usage

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

📚 Documentation

Research Tool

Name: research

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": "A comprehensive research report on quantum computing...\n\nSources:\n- https://example.com/source1\n- https://example.com/source2"
    }
  ]
}

🔧 Technical Details

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

Run formatting and linting using the provided scripts:

./run_format.sh
./run_lint.sh

📄 License

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