{
  "markdown": "# Mooring — Git & GitHub MCP Server\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-FB7185.svg)](LICENSE)\n\nMooring lines for your code — Git and GitHub operations for AI tools.\n\nMooring is an [MCP](https://modelcontextprotocol.io/) server that gives AI assistants structured access to local Git repositories and the GitHub API. Local operations use GitPython (no subprocess calls). GitHub operations use the PyGithub library with token masking and rate limit handling built in.\n\n---\n\n## Tools\n\n### Local Git\n\n| Tool | Description | Key Parameters |\n|------|-------------|----------------|\n| `repo_status` | Branch, ahead/behind, stash count, staged/unstaged/untracked files | `repo_path` |\n| `repo_log` | Commit log with optional filters | `repo_path`, `max_count`, `author`, `since`, `path`, `search` |\n| `repo_diff` | Unified diff — working tree, staged, or between refs | `repo_path`, `staged`, `from_ref`, `to_ref` |\n| `repo_blame` | Git blame with optional line range | `repo_path`, `file_path`, `start_line`, `end_line` |\n| `repo_branches` | All branches with tracking info, last commit, ahead/behind | `repo_path` |\n| `repo_stash` | Stash operations: list, push, pop, apply | `repo_path`, `action`, `message` |\n\n### GitHub\n\n| Tool | Description | Key Parameters |\n|------|-------------|----------------|\n| `gh_pr_list` | List pull requests | `repo`, `state`, `author`, `label` |\n| `gh_pr_detail` | PR detail with reviews, comments, and check runs | `repo`, `number` |\n| `gh_pr_create` | Create a pull request | `repo`, `title`, `body`, `head`, `base`, `labels`, `reviewers` |\n| `gh_issues` | List, create, or update issues | `repo`, `state`, `action`, `title`, `body`, `number` |\n| `gh_actions` | List recent GitHub Actions workflow runs | `repo`, `workflow`, `status` |\n\n### Utility\n\n| Tool | Description | Key Parameters |\n|------|-------------|----------------|\n| `health` | Server version and status check | _(none)_ |\n\n---\n\n## Installation\n\n```bash\n# PyPI\npip install mooring-mcp\n\n# Isolated install\npipx install mooring-mcp\n```\n\n---\n\n## Usage\n\nRun the server directly:\n\n```bash\nmooring\n```\n\n### Claude Code\n\n```bash\nclaude mcp add mooring -- mooring\n```\n\n### Claude Desktop\n\nAdd to your Claude Desktop configuration (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"mooring\": {\n      \"command\": \"mooring\",\n      \"env\": {\n        \"GITHUB_TOKEN\": \"your-github-personal-access-token\"\n      }\n    }\n  }\n}\n```\n\nThe `GITHUB_TOKEN` environment variable is required for all GitHub tools (`gh_*`). Local Git tools work without it.\n\n---\n\n## Security\n\n- **Path traversal protection** — file paths are resolved and validated against the repository root before any operation\n- **Symlink escape detection** — symlinks that resolve outside the repository are rejected\n- **Ref validation** — Git refs are checked against a safe character pattern and verified to exist before use\n- **Token masking** — error messages are scrubbed for GitHub token patterns (`ghp_*`, `gho_*`, `github_pat_*`) before being returned\n- **Rate limit handling** — GitHub 403 responses are caught and surfaced as clear messages instead of raw exceptions\n\n---\n\n## Development\n\n```bash\ngit clone https://github.com/seayniclabs/mooring.git\ncd mooring\npython -m venv .venv && source .venv/bin/activate\npip install -e \".[test]\"\npython -m pytest tests/ -q\n```\n\n---\n\n## Using with a Gateway\n\nIf you're running multiple MCP servers, route them through a gateway like [`tbxark/mcp-proxy`](https://github.com/tbxark/mcp-proxy) to manage all child processes from a single persistent service. The proxy handles process lifecycle, centralized config, and crash recovery — each server still gets its own SSE endpoint but you manage everything from one config file instead of scattered Claude Code entries.\n\nFor a full walkthrough of how this works in practice, see [The Hidden Cost of a Loaded MCP Stack](https://charlieseay.com/blog/mcp-gateway-lazy-loading) on charlieseay.com.\n\n## License\n\n[MIT](LICENSE)\n\n<!-- mcp-name: io.github.seayniclabs/mooring -->\n",
  "bytes": 4043,
  "sha": "48fee71b9f544bfc586fea16677d6a15f71006ce25f1bf4c2e292ba5d1188603",
  "repo_slug": "seayniclabs/mooring",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_seayniclabs_mooring_7dc63ea2/readme"
}