# mcp-oss-onramp [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/ryotaro-tanaka/mcp-oss-onramp.git  
**GitHub Stars:** 0  
**npm Downloads (last month):** 202  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mcp-oss-onramp

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

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation & README

# mcp-oss-onramp
**AI Scout for truly available, beginner-friendly OSS issues.**

[日本語版はこちら](https://github.com/ryotaro-tanaka/mcp-oss-onramp/blob/HEAD/docs/README_ja.md) | [Full Documentation](https://github.com/ryotaro-tanaka/mcp-oss-onramp/blob/HEAD/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

