# contribos

contribos is a Claude Code MCP server that extracts open-source repository policies and prepares pull requests for review. It checks test requirements and validates change descriptions.

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

## What it does

This server exposes nine tools for exploring open-source repositories and preparing patches. It parses project guidelines, extracts automated test expectations, and locates AI policies directly from repository files. The tool never submits pull requests or posts comments automatically. Every action remains manual.

Before submission, the server verifies test coverage by comparing runs with and without the patch, flags debugging artifacts, and analyzes reviewer feedback on existing PRs. Running it requires Python 3.10+ and `git`. Queries against remote GitHub issues require a `GITHUB_TOKEN` environment variable. Offline commands run via local `git` and store working copies in `~/.cache/contribos`.

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

## Install

### Claude Code (native platform)

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

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## When to use it
- check contribution rules and AI policies for a target repository
- run pre-submit checks on code diffs and test suites
- categorize reviewer comments on an open pull request
- discover suitable open issues filtered by maintainer response rates

## Example prompts
- Check contribution policies for pallets/flask using contribos
- Generate a task brief for this issue URL with contribos
- Run pre-submit verification on my current changes with contribos check

## Similar
- [github-contributor](https://affpapa.org/en/nevibecode/skills/github-contributor.md) — skill · 1000 installs
- [PR Etiquette](https://affpapa.org/en/nevibecode/skills/pr-etiquette.md) — skill · ★ 30 repo stars
- [OSS Contribution Best Practices](https://affpapa.org/en/nevibecode/skills/oss-contribution-best-practices.md) — skill · ★ 30 repo stars
- [om-merge-buddy](https://affpapa.org/en/nevibecode/skills/om-merge-buddy.md) — skill · 3600 installs
- [ce-resolve-pr-feedback](https://affpapa.org/en/nevibecode/skills/ce-resolve-pr-feedback.md) — skill · 3400 installs
- [review-pr](https://affpapa.org/en/nevibecode/skills/neolabhq-review-pr.md) — skill · 1300 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
