v0.1.2 — First public release

Fossick is an MCP server for prospecting across all of GitHub from your AI agent — find libraries, drill into repos, and search code patterns across 200M+ repos plus PyPI and npm.

This is the first public release.

Install

Add to your MCP client config (Claude Code, Cursor, Claude Desktop, VS Code, Windsurf, etc.):

{
  "mcpServers": {
    "fossick": {
      "command": "uvx",
      "args": ["fossick-mcp"]
    }
  }
}

Or, for Claude Code:

claude mcp add fossick --scope user uvx fossick-mcp

See the README for one-click install buttons (Cursor, VS Code) and per-client snippets.

Seven tools

A focused toolkit covering the full discovery loop — search, drill-down, and code pattern lookup across all of GitHub.

Find candidates

• search_repos — discover repositories by topic, stars, language, recency, with multi-query relevance ranking
• search_packages — direct PyPI / npm lookup

Drill into a candidate

• repo_tree — browse remote repo layout with depth + glob filters
• get_file — read any file at any branch, tag, or commit
• find_symbol — AST-based goto-definition for any class, function, or type
• list_tags — check freshness and recent releases

Search the code corpus

• search_code — full-text + regex search across every public file on GitHub

All tools are read-only, idempotent, and safe to auto-approve.

Highlights

• Lean on tokens by design — 7 focused tools, formatted-markdown output, TTL caching, hint chaining
• Multi-query search — pass N phrasings in one call, get merged + ranked results
• AST symbol search — works on any public repo without cloning
• Zero config for gh users — picks up your GitHub CLI token automatically
• Plays well with others — pair with github-mcp-server for repo management, WebFetch for arbitrary URLs

Links

• PyPI: https://pypi.org/project/fossick-mcp/
• README: https://github.com/Lipdog/fossick-mcp
• Architecture: CLAUDE.md
• Contributing: CONTRIBUTING.md

Built with FastMCP. MIT licensed.