# Sourcegull

The Sourcegull MCP server for Claude Code searches code and supports navigation across GitLab, GitHub, and Gitea repositories. An agent can query it to locate an implementation or trace related code.

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

## What it does

Sourcegull indexes GitLab, GitHub, and Gitea repositories for code search and navigation. Its MCP server returns relevant code lines to an agent rather than a full repository clone. The service runs on infrastructure you host.

Running Sourcegull requires a deployed server and PostgreSQL version 16 or newer; the agent connects to the server’s MCP address. Once connected, it can search source code and follow links between related parts. PostgreSQL 16 or newer is required for the server to run.

## Requirements
- Remote server: `https://{sourcegull_host}/.api/mcp`

## Install

### Claude Code (native platform)

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http sourcegull https://{sourcegull_host}/.api/mcp
```

### Codex

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add sourcegull --url https://{sourcegull_host}/.api/mcp
```

### Cursor

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "sourcegull": {
            "url": "https://{sourcegull_host}/.api/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "sourcegull": {
            "type": "http",
            "url": "https://{sourcegull_host}/.api/mcp"
        }
    }
}
```

### Gemini CLI

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http sourcegull https://{sourcegull_host}/.api/mcp
```

## When to use it
- locate a function across GitLab, GitHub, and Gitea repositories
- trace references between parts of a codebase
- retrieve relevant source lines through MCP

## Example prompts
- Find where authentication is implemented across the repositories.
- Trace which parts of the code call this method.
- Search all connected repositories for uses of this type.

## Similar
- [VIVATLAS](https://affpapa.org/en/nevibecode/mcp/vivatlas.md) — MCP server · ★ 9 repo stars
- [Vercel Grep](https://affpapa.org/en/nevibecode/mcp/vercel-grep.md) — MCP server · 1219 installs
- [greploop](https://affpapa.org/en/nevibecode/skills/greploop.md) — skill · 3100 installs
- [mcp-deepwiki](https://affpapa.org/en/nevibecode/skills/mcp-deepwiki.md) — skill · 3000 installs
- [read-github](https://affpapa.org/en/nevibecode/skills/read-github.md) — skill · 1200 installs
- [verify-and-ship](https://affpapa.org/en/nevibecode/skills/verify-and-ship.md) — skill · 888 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
