# Gread

Gread lets an AI agent search public GitHub repositories, inspect their trees, and read source files. Use it to explore a codebase from your coding client.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 21140 installs
- Author: nitrofire-q
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/nitrofire-q/gread
- Updated: 2026-05-11
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/nitrofire-q-gread

## What it does

Gread can find GitHub repositories by name, description, or topic, then show basic project details and its directory structure. If a matching documentation repository is available, it can be shown alongside the project. Access is limited to public GitHub repositories, so private source code is out of scope.

For a closer look, the agent can list a repository path, retrieve selected source files, or search within code using regular expressions or substring matching. Claude Code connects over HTTP with a `claude mcp add` command. The description also mentions a skill, but provides no skill setup command.

## Requirements
- Remote server: `https://gread--nitrofire-q.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http gread https://gread--nitrofire-q.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add nitrofire-q-gread --url https://gread--nitrofire-q.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "nitrofire-q-gread": {
            "url": "https://gread--nitrofire-q.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "nitrofire-q-gread": {
            "type": "http",
            "url": "https://gread--nitrofire-q.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http nitrofire-q-gread https://gread--nitrofire-q.run.tools
```

## When to use it
- find GitHub repositories by topic or name
- inspect a repository's directory tree
- read selected source files
- search code with a regular expression

## Example prompts
- Find public GitHub repositories about image processing and compare their descriptions.
- Inspect the tree of `owner/repo` and locate its configuration files.
- Search `owner/repo` for calls to `createClient`.

## Similar
- [atxp-git](https://affpapa.org/en/nevibecode/skills/atxp-git.md) — skill · 281 installs
- [gh-project-plugin](https://affpapa.org/en/nevibecode/plugins/gh-project-plugin.md) — plugin · ★ 1596 repo stars
- [get-started-stinger](https://affpapa.org/en/nevibecode/skills/get-started-stinger.md) — skill · ★ 96 repo stars
- [malware-detection-and-removal](https://affpapa.org/en/nevibecode/skills/malware-detection-and-removal.md) — skill · 957 installs
- [repo-standardizer](https://affpapa.org/en/nevibecode/skills/repo-standardizer.md) — skill · 33 installs
- [Claude Code Explorer MCP](https://affpapa.org/en/nevibecode/mcp/claude-code-explorer-mcp.md) — MCP server · ★ 6225 repo stars

## Other versions with the same name
- [gread · nitrorcr](https://affpapa.org/en/nevibecode/mcp/gread.md) — ★ 65 repo stars

---
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
