scoutdocs-mcp

MCP server that fetches and searches the latest stable documentation for any package. Keeps AI coding agents in sync with current APIs instead of relying on stale training data.

Two ways to run it:

• Local stdio (Python) — installs into Claude Code / Claude Desktop / Cursor, can read your project's manifests.

• Hosted Worker (Cloudflare) — public HTTPS endpoint at /mcp, no install required.

Why

LLMs are trained on a snapshot — the docs they "know" may be months or years old. scoutdocs-mcp gives any MCP client live access to the latest stable version info, READMEs, and search results across docs sites for packages on PyPI, npm, and crates.io.

How it works

Tools

Quickstart

Local (Python stdio)

scoutdocs-mcp is currently a beta release (0.2.0b3), so pip and uv need to be told it's OK to install a pre-release:

pip install --pre scoutdocs-mcp                # or
uv tool install --prerelease=allow scoutdocs-mcp

Add to Claude Code's MCP config (~/.claude/claude_code_config.json):

{
  "mcpServers": {
    "scoutdocs": {
      "command": "uvx",
      "args": ["--from", "scoutdocs-mcp==0.2.0b3", "scoutdocs-mcp"]
    }
  }
}

Once scoutdocs-mcp reaches 0.2.0 stable, the --pre / version-pin requirement goes away — you'll be able to run uvx --from scoutdocs-mcp scoutdocs-mcp directly. For Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS), use the same JSON shape.

Hosted (Cloudflare Worker)

Point any MCP client at the public Streamable HTTP endpoint:

https://scoutdocs-mcp.solmonger.workers.dev/mcp

The hosted endpoint is unauthenticated and rate-limited (60 MCP req/min, 10 search req/min per client IP). Search results are capped tighter than local (8 discovered pages × 18k chars / 200k total backstop) but well within Cloudflare free-tier headroom.

Example prompts

> What's the latest version of flask?
> Show me the docs for the serde crate
> Search the httpx docs for "transport"
> What dependencies does this project declare?

Configuration

GitHub token (optional, local only)

Unauthenticated GitHub API allows 60 req/hr. A token (any scope) raises that to 5,000/hr — useful when fetching READMEs in bulk:

export GITHUB_TOKEN=ghp_your_token_here

Cache

• Local stdio: SQLite at ~/.cache/scoutdocs-mcp/cache.db, 24h TTL.

• Hosted Worker: Cloudflare KV, same 24h TTL, scoped per binding.

Search caps

The README is always included as a free first page. The max_pages cap governs how many discovered pages we add on top of it.

Supported ecosystems

If no ecosystem is specified, registries are tried in order.

Repository layout

src/scoutdocs_mcp/    Python stdio server (published as scoutdocs-mcp)
worker/               Cloudflare Worker (TypeScript) for the hosted endpoint
tests/                pytest suite (mocked HTTP)
worker/test/          Vitest suite (Cloudflare workers pool)
docs/RELEASE.md       Release & deployment runbook

Status

Beta (0.2.0b3). API stable; some discovery sources may evolve. Filed issues welcome at https://github.com/eshaanmathakari/scoutdocs-mcp/issues.

License

MIT