Skip to main content

MCP server for consulting large context window models to analyze extensive file collections

Project description

Consult7 MCP Server

Consult7 is a Model Context Protocol (MCP) server that enables AI agents to consult large context window models for analyzing extensive file collections - entire codebases, document repositories, or mixed content that exceed the current agent's context limits. Supports providers Openrouter, OpenAI, and Google.

Why Consult7?

When working with AI agents that have limited context windows (like Claude with 200K tokens), Consult7 allows them to leverage models with massive context windows to analyze large codebases or document collections that would otherwise be impossible to process in a single query.

"For Claude Code users, Consult7 is a game changer."

How it works

Consult7 recursively collects all files from a given path that match your regex pattern (including all subdirectories), assembles them into a single context, and sends them to a large context window model along with your query. The result of this query is directly fed back to the agent you are working with.

Example Use Cases

Summarize an entire codebase

  • Query: "Summarize the architecture and main components of this Python project"
  • Pattern: ".*\.py$" (all Python files)
  • Path: /Users/john/my-python-project

Find specific method definitions

  • Query: "Find the implementation of the authenticate_user method and explain how it handles password verification"
  • Pattern: ".*\.(py|js|ts)$" (Python, JavaScript, TypeScript files)
  • Path: /Users/john/backend

Analyze test coverage

  • Query: "List all the test files and identify which components lack test coverage"
  • Pattern: ".*test.*\.py$|.*_test\.py$" (test files)
  • Path: /Users/john/project

Complex analysis with thinking mode

  • Query: "Analyze the authentication flow across this codebase. Think step by step about security vulnerabilities and suggest improvements"
  • Pattern: ".*\.(py|js|ts)$"
  • Model: "google/gemini-2.5-flash|thinking" (with OpenRouter) or "gemini-2.5-flash|thinking" (with Google)
  • Path: /Users/john/webapp

Installation

Claude Code

Simply run:

# OpenRouter
claude mcp add -s user consult7 uvx -- consult7 openrouter your-api-key

# Google AI
claude mcp add -s user consult7 uvx -- consult7 google your-api-key

# OpenAI
claude mcp add -s user consult7 uvx -- consult7 openai your-api-key

Claude Desktop

Add to your Claude Desktop configuration file:

{
  "mcpServers": {
    "consult7": {
      "type": "stdio",
      "command": "uvx",
      "args": ["consult7", "openrouter", "your-api-key"]
    }
  }
}

Replace openrouter with your provider choice (google or openai) and your-api-key with your actual API key.

No installation required - uvx automatically downloads and runs consult7 in an isolated environment.

Command Line Options

uvx consult7 <provider> <api-key> [--test]
  • <provider>: Required. Choose from openrouter, google, or openai
  • <api-key>: Required. Your API key for the chosen provider
  • --test: Optional. Test the API connection

The model is specified when calling the tool, not at startup. The server shows example models for your provider on startup.

Thinking Mode

Enable advanced reasoning/thinking modes by adding the |thinking suffix to supported models:

  • OpenRouter: "google/gemini-2.5-flash|thinking" - Enables reasoning mode with high effort
  • Google: "gemini-2.5-flash|thinking" - Enables thinking mode with dynamic budget

Testing

# Test OpenRouter
uvx consult7 openrouter sk-or-v1-... --test

# Test Google AI
uvx consult7 google AIza... --test

# Test OpenAI
uvx consult7 openai sk-proj-... --test

Uninstalling

To remove consult7 from Claude Code (or before reinstalling):

claude mcp remove consult7 -s user

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

consult7-1.2.0.tar.gz (11.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

consult7-1.2.0-py3-none-any.whl (12.6 kB view details)

Uploaded Python 3

File details

Details for the file consult7-1.2.0.tar.gz.

File metadata

  • Download URL: consult7-1.2.0.tar.gz
  • Upload date:
  • Size: 11.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.7.2

File hashes

Hashes for consult7-1.2.0.tar.gz
Algorithm Hash digest
SHA256 b1d0dfa75292b8d9560298ea70375a349d86b1c9458f7e771a7a2ff9684b50ef
MD5 1b3cbd1636fbf1b56875af0bde631706
BLAKE2b-256 e55aa3278fbf994bdd0a1d6ee8be17364570d9e5333088e4672d3de966784879

See more details on using hashes here.

File details

Details for the file consult7-1.2.0-py3-none-any.whl.

File metadata

  • Download URL: consult7-1.2.0-py3-none-any.whl
  • Upload date:
  • Size: 12.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.7.2

File hashes

Hashes for consult7-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b536cef9f5b90a555dae6695b971c51311dd3a03465100327dfcefbcfe3fef14
MD5 ad1486d5c59d9a5a7829de594a7de036
BLAKE2b-256 3292a208a72fa2b7737159261420dd7f7457c30a5dc9bdec1a4f6167b20d42cc

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page