open-source-contribution-mcp-server
Provides tools for discovering open-source issues, analyzing repository context, generating code fixes and unit tests, submitting pull requests, tracking PR status, and retrieving review feedback on GitHub.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@open-source-contribution-mcp-server Find good first issues for TypeScript"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
π Open Source Contribution MCP Server (open-source-contribution-mcp-server)
An end-to-end Model Context Protocol (MCP) Server that enables AI clients (Claude Desktop, Cursor, AI agents) to autonomously discover, analyze, fix, test, submit, and track open-source contributions on GitHub.
π Overview
Making your first (or 50th) open-source contribution can be intimidating: finding active repositories with open PR queues, understanding unwritten codebase conventions, passing strict linters, and avoiding silent CI failures.
This MCP server provides 12 specialized tools across 6 domain modules to automate the entire contribution lifecycle.
Related MCP server: mcp-oss-onramp
π οΈ Complete Tool Catalog (12 Tools)
π€ 1. Skill & Preference Management Module
Allows AI clients to store and reference your tech stack, language proficiencies, and project preferences.
Tool Name | Parameters | Description |
| None | Returns your stored tech stack, proficiency levels, and project preferences. |
|
| Overwrites your profile with new skills and preferences (saved to |
|
| Appends new skills to your profile without clobbering preferences. |
|
| Removes a specific skill from your profile. |
| None | Resets your skill profile back to default settings. |
π 2. Repository & Issue Discovery Module
Filters GitHub for high-confidence, active repositories with zero PR queues.
Tool Name | Parameters | Description |
|
| Searches GitHub for open |
π 3. Deep Repository Context & Analysis Module
Inspects repository rules, linters, and architectural patterns before writing code.
Tool Name | Parameters | Description |
|
| Reads target issue details, |
π οΈ 4. Code & Test Generation Module
Synthesizes compliant source code patches and unit tests.
Tool Name | Parameters | Description |
|
| Generates a compliant source fix obeying repository formatting & line length constraints. |
|
| Synthesizes unit tests (with mock coverage) to verify the fix and prevent regressions. |
π 5. Automated Pull Request Module
Automates the complete GitHub Git workflow.
Tool Name | Parameters | Description |
|
| Forks the repo, creates a branch, commits files, pushes to your fork, and submits a PR to upstream. |
|
| Checks status, mergeability, CI workflow check runs, and merge state of a PR. |
π¬ 6. Review Feedback & Iteration Module
Keeps PRs moving toward merge.
Tool Name | Parameters | Description |
|
| Pulls review comments (from maintainers & bots like Copilot) and failed CI step logs to guide single-try fixes. |
π GitHub Personal Access Token (PAT) Setup
To allow the MCP Server to search repositories, inspect codebases, fork repos, and create pull requests, you need a GitHub Personal Access Token.
Step-by-Step Instructions:
Go to GitHub Settings: GitHub Developer Settings > Personal Access Tokens (Classic)
Click Generate new token (classic).
Set a descriptive note:
MCP Open Source Contribution Server.Select the following required scopes:
repo(Full control of private/public repositories β required for forking & creating PRs)workflow(Update GitHub Action workflows β required if modifying workflow files)user:email(Access user email addresses)
Click Generate token and copy the generated token string (
ghp_...).Store it in your
.envfile or environment variables:
GITHUB_TOKEN=ghp_your_personal_access_token_hereβ‘ Installation & Setup
Prerequisites
Node.js:
v18.0.0or highernpm or yarn or pnpm
Git installed on system path
1. Clone & Install Dependencies
git clone https://github.com/your-username/open-source-contribution-mcp-server.git
cd open-source-contribution-mcp-server
npm install2. Configure Environment
Create a .env file in the root directory (or copy .env.example):
cp .env.example .envEdit .env and add your GitHub Personal Access Token:
GITHUB_TOKEN=ghp_your_personal_access_token_here3. Build the TypeScript Server
npm run buildπ Connecting to MCP Clients
A. Claude Desktop Integration
Add the server to your Claude Desktop configuration file:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"open-source-contributions": {
"command": "node",
"args": [
"C:/path/to/open-source-contribution-mcp-server/dist/index.js"
],
"env": {
"GITHUB_TOKEN": "ghp_your_personal_access_token_here"
}
}
}
}B. Cursor / Antigravity Integration (mcp_config.json)
{
"mcpServers": {
"open-source-contributions": {
"command": "node",
"args": [
"C:/path/to/open-source-contribution-mcp-server/dist/index.js"
],
"env": {
"GITHUB_TOKEN": "ghp_your_personal_access_token_here"
}
}
}
}π§ͺ Testing & MCP Inspector
You can inspect and test all 12 tools interactively using the official @modelcontextprotocol/inspector:
npm run inspectorThis launches the interactive MCP web UI at http://localhost:5173.
π Real-World Battle-Tested Proof
This MCP server has been battle-tested on live open-source repositories:
π£
mldsveda/PyScrappyPR #139 β MERGED TOmainFixed a critical atomic file-saving bug (
tempfile.mkstemp+os.replace()). Passed 100% of Python 3.9β3.13 unit tests and Ruff formatting.
π’
fu351/Doberman-CorePR #345 β OPEN & PASSING CIRetuned light-mode verdict badge colors to clear WCAG AA 4.5:1 text contrast with unit tests.
π License
Distributed under the ISC License. See LICENSE for more information.
Available Tools
12 toolsadd_user_skillsB
Dynamically add new skills or update existing skill proficiencies anytime
Inputs: skills (required).
analyze_repo_contextA
Mandatory repo analysis: reads CONTRIBUTING guidelines, linter configs, test frameworks, and recent merged PRs
Inputs: repo (required).
clear_user_skillsB
Reset all user skills and preferences
Inputs: no named parameters.
find_issuesB
Discover and rank open-source issues matching user skills across multiple sources
Inputs: limit, overrideSkills.
generate_code_fixB
Generate scoped, file-level diff fix for an issue adhering to target repo conventions
Inputs: repo (required), issueNumber (required), fixDescription (required), targetFilePath (required), +1 more.
generate_unit_testsB
Generate matching unit tests for the proposed code fix
Inputs: repo (required), testCode (required), testFilePath (required), testFramework (required).
get_review_feedbackA
Fetch maintainer review comments for a PR and generate follow-up fix instructions
Inputs: repo (required), prNumber (required).
get_user_skillsA
Get currently registered skills, proficiency levels, and scope preferences
Inputs: no named parameters.
remove_user_skillA
Remove a specific skill tag from active profile
Inputs: skillName (required).
set_user_skillsB
Set or overwrite user skill tags and scope preferences
Inputs: skills (required), avoidTags, scopePreferences.
submit_pull_requestA
Submit approved pull request to target repository (Only runs when confirmed is set to true by human approval)
Inputs: repo (required), prBody (required), prTitle (required), filePath (required), +5 more.
track_open_prsB
Track status of PRs (open, changes requested, approved, merged, closed)
Inputs: repo (required), prNumber (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 12 tools
Each tool has a clearly distinct purpose, with user skills tools covering separate CRUD operations (get, set, add, remove, clear) and the remaining tools targeting different workflow stages (issue discovery, repo analysis, PR tracking, code/test generation, submission, feedback). There is no meaningful overlap between any two tools, even within the skills family, as descriptions clarify the differences in behavior.
All tools follow a consistent verb_noun snake_case pattern (e.g., get_user_skills, find_issues, generate_code_fix). The verbs and nouns are descriptive and align with the action, and there is no mixing of conventions or unusual naming styles.
With 12 tools, the server is well-scoped for its stated purpose of managing open-source contributions. Each tool covers a necessary step in the workflow, from profile management to submission and feedback, without redundancy or bloat.
The tool set covers the core workflow comprehensively: skills management, issue discovery, repository analysis, fix and test generation, PR submission, tracking, and review feedback. The main gap is the lack of a tool to update an existing PR with follow-up fixes after review feedback, leaving a potential dead end in the iterative contribution loop.
Maintenance
Related MCP Connectors
An MCP server that gives your AI access to the source code and docs of all public github repos
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
A MCP server built for developers enabling Git based project management with project and personalβ¦
Nifty's MCP server β exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA production-ready MCP server that provides AI assistants with comprehensive GitHub developer tooling including PR analysis, code review, changelog generation, dependency auditing, commit summarization, and refactoring suggestions.MIT
- AlicenseAqualityDmaintenanceAn MCP server that scouts truly beginner-friendly open-source issues from GitHub, checking availability and summarizing them for AI consumption.139 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP server that equips AI agents with dev workflow tools including GitHub project management, conventional commits, visual regression testing, Jira/Confluence integration, and a persistent memory knowledge graph.14 npmMIT
- AlicenseAqualityBmaintenanceAn MCP server that enables autonomous code development by pulling GitHub issues, fixing them in a sandboxed environment, running tests, opening PRs, and promoting to production upon human approval.3AGPL 3.0