# Fossick

Fossick lets an AI agent search GitHub, PyPI, and npm for libraries, repositories, and real code usage. Use it when evaluating a dependency or API.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: Lipdog
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Lipdog/fossick-mcp
- Updated: 2026-04-13
- HTML: https://affpapa.org/en/nevibecode/mcp/fossick

## What it does

Fossick exposes seven read-only tools for code discovery. The server searches GitHub repositories and packages on PyPI and npm, ranks results by relevance, opens a remote repository tree, and reads files without a local clone. It can also locate class, function, and type definitions and search public code for real API usage.

Use it to compare libraries, inspect a dependency before adoption, or trace an unfamiliar project from its repository layout to the relevant source file. It can surface examples from production code and help check recent package activity. Fossick does not handle blame, pull request history, or version diffs; those tasks belong to `git` and `gh`.

Install `uv` first, then run the server through `uvx fossick-mcp`. Without `uv`, the setup command will fail.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add fossick -- uvx fossick-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from fossick-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add fossick -- uvx fossick-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from fossick-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "fossick": {
            "command": "uvx",
            "args": [
                "fossick-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from fossick-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "fossick": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "fossick-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from fossick-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add fossick uvx fossick-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from fossick-mcp <command>

## When to use it
- find a library for a specific task
- check a package before adding it
- inspect a repository without cloning it
- locate real API usage in public code
- compare dependency freshness and activity

## Example prompts
- Find a small Rust terminal UI library and compare it with the common alternatives.
- Show how public FastAPI projects configure structured logging with `structlog`.
- Browse `astral-sh/uv`, locate the definition of the target class, and read its source file.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md