io.github.ryotaro-tanaka/mcp-oss-onramp
MCP server to scout beginner-friendly OSS issues with high precision using GitHub GraphQL
Open source Open in the app JSON README (API)
About
MCP server to scout beginner-friendly OSS issues with high precision using GitHub GraphQL
Details
- Kind
- MCP servers
- Topic
- Developer tools
- Publisher
- ryotaro-tanaka
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.3
- Forks
- 1
- Open pull requests
- 1
- Last push
- 2026-05-21T01:47:41Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 04:01:20
- Updated
- 2026-08-29 04:01:20
- Origin id
io.github.ryotaro-tanaka/mcp-oss-onramp
README
# mcp-oss-onramp
**AI Scout for truly available, beginner-friendly OSS issues.**
[日本語版はこちら](./docs/README_ja.md) | [Full Documentation](./docs/README_full.md)
## 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)](https://cli.github.com/) 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