gptr-mcp  by assafelovic

Deep research server for LLM applications

Created 7 months ago
271 stars

Top 94.9% on SourcePulse

GitHubView on GitHub
1 Expert Loves This Project
Project Summary

Summary

GPT Researcher MCP Server provides an MCP-compliant server that enables LLM applications to perform deep, validated web research. It addresses the limitations of standard search tools by autonomously exploring and filtering numerous sources, delivering higher quality, optimized, and comprehensive information for LLMs. This benefits developers building LLM-powered research tools and users of applications like Claude Desktop.

How It Works

The project implements an MCP server for GPT Researcher, allowing LLM applications to request in-depth research. Instead of returning raw search results, it autonomously navigates, validates, and synthesizes information from multiple trusted sources. This approach prioritizes accuracy and relevance, optimizing context window usage and providing LLMs with superior data for reasoning, albeit with a slightly longer processing time of around 30 seconds.

Quick Start & Requirements

Installation involves cloning the repository, installing dependencies via pip install -r requirements.txt, and running python server.py. For production, Docker is recommended (docker-compose up -d). Prerequisites include Python 3.11+, an OpenAI API key, and a Tavily API key (or other supported retriever keys). Detailed setup instructions and integration guides for Claude Desktop are available.

Highlighted Details

  • Deep Research Capability: Enables LLMs to conduct autonomous, validated web research beyond simple search queries.
  • Flexible Transport Modes: Supports STDIO for local development (e.g., Claude Desktop), SSE for Docker/web/n8n integration, and Streamable HTTP for modern web deployments, with automatic environment detection.
  • Claude Desktop Integration: Offers comprehensive guides and configuration examples for seamless integration with Claude Desktop, including secure API key management.
  • Tooling: Exposes research functions like deep_research, quick_search, write_report, and source retrieval.

Maintenance & Community

Community support is available via a Discord server. Contact information is provided via email. No specific details on core maintainers, sponsorships, or a public roadmap are present in the README.

Licensing & Compatibility

The project is licensed under the MIT License, which permits broad use, including commercial applications and linking within closed-source projects.

Limitations & Caveats

Research tasks take approximately 30 seconds, longer than standard search. Integration with Claude Desktop requires precise configuration of absolute paths and environment variables in claude_desktop_config.json. SSE and HTTP transports necessitate session management via the /sse endpoint. Python 3.11+ is a strict requirement.

Health Check
Last Commit

4 months ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
4
Star History
19 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.