RepoPilot MCP
Evaluates GitHub issues for newcomer accessibility using explainable heuristics, providing clear rationale and direct evidence links to help open-source contributors discover beginner-friendly issues.
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., "@RepoPilot MCP find beginner-friendly issues in facebook/react and explain why they fit newcomers"
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.
RepoPilot MCP
A local Model Context Protocol (MCP) server designed to help open-source contributors discover potentially beginner-friendly GitHub issues using explainable heuristics and evidence links.
Overview
RepoPilot MCP connects LLM-powered developer environments directly to open-source repository insights over standard I/O (stdio). It is built to assist contributors by evaluating issues for newcomer accessibility with clear rationale, reproducible heuristics, and direct evidence links.
This repository is currently in its initial foundation stage. GitHub API integration and domain-specific MCP tools are scheduled for subsequent iterations.
Related MCP server: contrib-radar
Architectural Principles
Modern ES Modules (
NodeNext): Configured for Node.js native ESM ("type": "module") targeting modern Node.js runtimes (>=20.0.0).Current Official MCP SDK: Uses
@modelcontextprotocol/sdkwith the official high-levelMcpServerabstraction.Strict Stderr Logging: In stdio MCP servers,
process.stdoutis exclusively reserved for JSON-RPC message framing. All logs, diagnostics, and notifications are strictly directed toprocess.stderrto prevent protocol stream corruption.Runtime Schema Validation: Employs Zod for all configuration, input schemas, and future MCP tool parameter validation.
Quality Gates: Automated typechecking (
tsc), linting (eslintflat config), code formatting (prettier), and unit tests (vitest).
Project Structure
repopilot-mcp/
├── .github/
│ └── workflows/
│ └── ci.yml # GitHub Actions CI workflow (typecheck, lint, test, build)
├── src/
│ ├── cli.ts # Executable stdio entrypoint (bin target)
│ ├── index.ts # Public library API exports
│ ├── logger.ts # Stderr-only logger utility
│ └── server.ts # McpServer factory with Zod validation
├── tests/
│ ├── logger.test.ts # Stderr output and log-level tests
│ └── server.test.ts # Server instantiation and schema validation tests
├── eslint.config.js # ESLint 9+ flat config with typescript-eslint & prettier
├── package.json # Package configuration, scripts, bin, and dependencies
├── tsconfig.json # TypeScript configuration for development & tests
├── tsconfig.build.json # TypeScript configuration for dist build
├── vitest.config.ts # Vitest configuration
└── README.mdGetting Started
Prerequisites
Node.js:
>= 20.0.0(Recommended: latest LTS or Current)npm:
>= 10.0.0
Installation
Clone the repository and install dependencies:
git clone https://github.com/adity0208/repopilot-mcp.git
cd repopilot-mcp
npm installAvailable Scripts
Script | Command | Description |
|
| Compiles TypeScript source to |
|
| Validates types across source and test files |
|
| Runs unit test suite |
|
| Runs tests in interactive watch mode |
|
| Checks code against TypeScript and style rules |
|
| Automatically fixes auto-fixable lint issues |
|
| Verifies code formatting |
|
| Formats all files according to Prettier rules |
MCP Host Integration (Local Testing)
Once built, the server can be registered in any MCP-compliant client (e.g., Claude Desktop, Antigravity, or Cursor) using standard I/O:
{
"mcpServers": {
"repopilot": {
"command": "node",
"args": ["<PATH_TO_REPOPILOT_MCP>/dist/cli.js"]
}
}
}License
Available Tools
1 toolfind_starter_issuesA
Discovers potentially beginner-friendly GitHub issues for a repository using explainable heuristics, confidence tiers, and evidence links.
Inputs: repo (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of overlap or misselection. Its purpose is clearly distinct and self-contained.
The single tool follows a clear verb_noun naming convention: find_starter_issues. Although consistency cannot be tested across multiple tools, the convention itself is predictable and readable.
A single tool is borderline thin for a server named RepoPilot MCP, which suggests broader repository assistance. The tool is focused, but the surface feels under-scoped.
For the narrow task of discovering beginner-friendly issues, the tool may be self-contained. However, obvious adjacent operations such as fetching issue details, listing issues, or retrieving repository context are missing, creating potential dead ends for agent workflows.
Maintenance
Related MCP Connectors
Issue tracker for coding agents: a real backlog, plus a risk-ranked review of every change.
1Find open-source GitHub issues to contribute to, matched to your skills; you approve every PR.
Finds real, maintained open-source repos that fit your project. MCP grounding for coding agents.
Dependency picker for coding agents: recommends, compares and scores GitHub repos with a verdict.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables LLMs to list, create, and comment on GitHub issues using your own GitHub identity via stdio transport.3MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to evaluate real OSS contribution opportunities by scoring issues on availability, competing PRs, staleness, and maintainer sentiment, including live feasibility checks for any repository.MIT
- AlicenseNot gradedqualityBmaintenanceExposes code-review and issue-triage tools to AI assistants over stdio, letting them evaluate unified pull-request diffs for maintainer remarks, slice diffs into categorized AST hunks, and classify GitHub issues by priority while synthesizing minimal reproduction stubs.1Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables developers to discover and evaluate contribution opportunities in public GitHub repositories through structured analysis of issues, code, and repository metadata.MIT