io.github.ryotaro-tanaka/mcp-oss-onramp

Official

by ryotaro-tanaka · JavaScript

MCP server to scout beginner-friendly OSS issues with high precision using GitHub GraphQL

MCP OSS Onramp

This MCP server (io.github.ryotaro-tanaka/mcp-oss-onramp) scouts beginner-friendly open source issues with high precision using GitHub GraphQL. It is described as an MCP server within the Model Context Protocol ecosystem and is associated with topics including github-api, mcp, and model-context-protocol.

🛠️ Key Features

Uses GitHub GraphQL to scout issues
Focus on beginner-friendly OSS issues
Exposes Model Context Protocol (MCP) server functionality

🚀 Use Cases

Find beginner-friendly OSS issues for contribution
Use in an AI agent configured with an MCP server entry

⚡ Developer Benefits

Run with npx mcp-oss-onramp
Optionally run via CLI with MCP_OSS_ONRAMP_GITHUB_TOKEN
MCP agent integration via mcpServers configuration

⚠️ Limitations

Requires GitHub access when using the token-based CLI execution method

Topics

beginner-friendlygithub-apimcpmcp-servermodel-context-protocoloss-contribution

README.md1 KBView on GitHub

mcp-oss-onramp

AI Scout for truly available, beginner-friendly OSS issues.

日本語版はこちら | Full Documentation

Quick Start

Run directly via npx:

bash

npx mcp-oss-onramp

Direct Execution (CLI)

You can also run the server with a token directly in your terminal:

bash

MCP_OSS_ONRAMP_GITHUB_TOKEN="your_token_here" npx mcp-oss-onramp

MCP Configuration

Add this to your AI agent's configuration:

json

{
  "mcpServers": {
    "oss-onramp": {
      "command": "npx",
      "args": ["-y", "mcp-oss-onramp"]
    }
  }
}

Features

True Availability: Checks linked PRs via GraphQL to filter out issues already being worked on.
AI-Optimized: Summarizes issue bodies for efficient LLM consumption.
High Precision: Targets beginner-friendly tasks even without explicit labels.

Prerequisites

GitHub Authentication (Recommended):
- Set MCP_OSS_ONRAMP_GITHUB_TOKEN environment variable, OR
- Install GitHub CLI (gh) and authenticate via gh auth login.
Node.js: Version 18 or higher.

Note: The server works without authentication but will be rate-limited and provide lower precision (no PR cross-referencing).

License

MIT

Install

Add to VS Code Add to Cursor

claude_desktop_config.json