代码导航工具

pip install pipx && python -m pipx ensurepath
# Close and reopen your terminal

pipx install scout-code-navigator

{
  "mcpServers": {
    "scout": {
      "command": "scout",
      "args": []
    }
  }
}

claude mcp add scout -s user -- scout

"Analyze https://github.com/pallets/flask and explain how routing works"

"How does authentication work in this codebase?"

"Find all the database models in https://github.com/django/django"

"Where is the rate limiting logic implemented?"

"Explore my local project at /path/to/my/project and summarize the architecture"

You ask: "How does routing work in this Flask app?"
                    |
                    v
Claude calls tools in sequence:
┌────────────────────────────────────────────────────────┐
│ 1. repo_overview  → directory tree + README + stack    │
│ 2. search_code    → ripgrep for "def route", "@app."   │
│ 3. read_file      → read matching files at line ranges │
└────────────────────────────────────────────────────────┘
                    |
                    v
Claude explains the actual code to you

# Repository cloning (GitHub URLs only — local repos need nothing)
REPO_STORAGE_PATH=~/.scout/repos   # Where cloned repos are cached
REPO_CACHE_TTL_HOURS=24            # How long before re-cloning
REPO_CLONE_TIMEOUT_SECONDS=300     # Max time to wait for a clone

# HTTP Server mode only
SERVER_HOST=0.0.0.0
SERVER_PORT=8000

# Option 1: GitHub CLI (recommended)
gh auth login

# Option 2: SSH key (if already set up, nothing extra needed)

# Option 3: Credential helper
git config --global credential.helper store

# Start the server
scout-http
# Runs on http://localhost:8000
# API docs at http://localhost:8000/docs

claude mcp add --transport http scout http://localhost:8000

pipx install scout-code-navigator

{
  "mcpServers": {
    "scout": {
      "command": "python",
      "args": ["-m", "mcp_stdio_server"]
    }
  }
}

brew install ripgrep          # macOS
apt install ripgrep           # Ubuntu/Debian
scoop install ripgrep         # Windows
winget install BurntSushi.ripgrep  # Windows (alternative)

git clone https://github.com/MayankSethi27/scout.git
cd scout
python -m venv venv && source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -e ".[dev]"

# Run tests
pytest

# Run a single test
pytest tests/unit/test_services.py::TestSearchCode

# Format code
black . && isort .

# Run the stdio server locally
python mcp_stdio_server.py

# Run the HTTP server locally
python mcp_server.py