# gitmanual

gitmanual — an MCP server for Claude Code that fetches setup guides and installation steps for GitHub repositories. Retrieves platform-specific run commands directly from repo files.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 268 repo stars
- Author: zainudinnoori
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/zainudinnoori/gitmanual
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/gitmanual

## What it does

The server turns public GitHub repositories into structured installation walkthroughs without cloning full source trees. It inspects metadata, release files, container definitions, and manifests to determine language runtimes and database requirements.

Two MCP tools handle the work: `get_setup_manual` provides explicit operating system guidance, while `get_setup_script` generates idempotent shell scripts. The outputs include required environment flags, package manager calls, and hardware checks.

Remote connectivity relies on the hosted URL `https://gitmanual.com/mcp` with zero login requirements. Running the service locally demands Node.js 20.9+ alongside an optional `GITHUB_TOKEN`.

## Requirements
- Remote server: `https://gitmanual.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http gitmanual https://gitmanual.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add gitmanual --url https://gitmanual.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "gitmanual": {
            "url": "https://gitmanual.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "gitmanual": {
            "type": "http",
            "url": "https://gitmanual.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http gitmanual https://gitmanual.com/mcp
```

## When to use it
- generate build instructions for any GitHub repo
- verify hardware and operating system compatibility
- fetch ready-to-run setup scripts for bash or PowerShell
- extract required environment variables and dependencies

## Example prompts
- Fetch the setup manual for `ollama/ollama` on macOS
- Generate an installation script for `zainudinnoori/gitmanual` on Windows
- Check if repository `owner/repo` can run on Linux

## Similar
- [cyrus-setup-prerequisites](https://affpapa.org/en/nevibecode/skills/cyrus-setup-prerequisites.md) — skill · 1100 installs
- [ce-setup](https://affpapa.org/en/nevibecode/skills/ce-setup.md) — skill · 3600 installs
- [github-actions](https://affpapa.org/en/nevibecode/skills/bobmatnyc-github-actions.md) — skill · 778 installs
- [cursor-setup](https://affpapa.org/en/nevibecode/skills/cursor-setup.md) — skill · ★ 3219 repo stars
- [encore-getting-started](https://affpapa.org/en/nevibecode/skills/encore-getting-started.md) — skill · 727 installs
- [glab-ci](https://affpapa.org/en/nevibecode/skills/glab-ci.md) — skill · 169 installs

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