contribos — Claude Code MCP server: what it does, how to install
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.
MIT ★ 14 updated 2026-11-06
claude mcp add contribos -- uvx contribosWhat contribos 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.
What it helps with
- 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 for the agent
- 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
How to install contribos
Platform CLI
claude mcp add contribos -- uvx contribosuvx runs the command named after the package; if the README names another one, use uvx --from contribos <command>
Platform CLI
codex mcp add contribos -- uvx contribosuvx runs the command named after the package; if the README names another one, use uvx --from contribos <command>
Config file
{
"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>
Config file
{
"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>
Platform CLI
gemini mcp add contribos uvx contribosuvx runs the command named after the package; if the README names another one, use uvx --from contribos <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about contribos
How to install contribos in Claude Code?
Run claude mcp add contribos -- uvx contribos. You also need Python 3.10 or higher and git installed on your machine.
What does contribos do?
It provides tools to analyze open-source repositories: extracting guidelines and AI rules, preparing task summaries, and running pre-submit checks on changes.
What is required to run contribos?
It requires Python 3.10+ and git. Working with remote issues and pull request reviews also requires setting the GITHUB_TOKEN environment variable.