Skip to main content
Glama
open-source-contribution-mcp-server

open-source-contribution-mcp-server

πŸš€ Open Source Contribution MCP Server (open-source-contribution-mcp-server)

TypeScript Model Context Protocol License: ISC

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

get_user_skills

None

Returns your stored tech stack, proficiency levels, and project preferences.

set_user_skills

skills, preferences

Overwrites your profile with new skills and preferences (saved to skills.json).

add_user_skills

skills

Appends new skills to your profile without clobbering preferences.

remove_user_skill

name

Removes a specific skill from your profile.

clear_user_skills

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

find_issues

query, languages, limit

Searches GitHub for open good first issue / help wanted issues in repos with active maintainers, low open PR queues, and recent commit activity.

πŸ“Š 3. Deep Repository Context & Analysis Module

Inspects repository rules, linters, and architectural patterns before writing code.

Tool Name

Parameters

Description

analyze_repo_context

repo, issueNumber

Reads target issue details, CONTRIBUTING.md, linter configs (ruff, eslint, line lengths), target source files, and test files.

πŸ› οΈ 4. Code & Test Generation Module

Synthesizes compliant source code patches and unit tests.

Tool Name

Parameters

Description

generate_code_fix

repo, issueNumber, instructions

Generates a compliant source fix obeying repository formatting & line length constraints.

generate_unit_tests

repo, issueNumber, targetFile, instructions

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

submit_pull_request

repo, branchName, title, body, files

Forks the repo, creates a branch, commits files, pushes to your fork, and submits a PR to upstream.

track_open_prs

repo, prNumber

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

get_review_feedback

repo, prNumber

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:

  1. Go to GitHub Settings: GitHub Developer Settings > Personal Access Tokens (Classic)

  2. Click Generate new token (classic).

  3. Set a descriptive note: MCP Open Source Contribution Server.

  4. 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)

  5. Click Generate token and copy the generated token string (ghp_...).

  6. Store it in your .env file or environment variables:

GITHUB_TOKEN=ghp_your_personal_access_token_here

⚑ Installation & Setup

Prerequisites

  • Node.js: v18.0.0 or higher

  • npm 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 install

2. Configure Environment

Create a .env file in the root directory (or copy .env.example):

cp .env.example .env

Edit .env and add your GitHub Personal Access Token:

GITHUB_TOKEN=ghp_your_personal_access_token_here

3. 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.json

  • macOS: ~/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 inspector

This 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:

  1. 🟣 mldsveda/PyScrappy PR #139 β€” MERGED TO main

    • Fixed a critical atomic file-saving bug (tempfile.mkstemp + os.replace()). Passed 100% of Python 3.9–3.13 unit tests and Ruff formatting.

  2. 🟒 fu351/Doberman-Core PR #345 β€” OPEN & PASSING CI

    • Retuned 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 tools
add_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

    A3.7/5.0

    Scored across 12 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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
    • A
      license
      A
      quality
      B
      maintenance
      An 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.
      3
      AGPL 3.0