Gfi Scout MCP server
io.github.Rajveerx11/gfi-scout·v0.2.0Finds open source issues where beginners actually succeed, ranked by a 0-100 beginner score.
0 stars17 downloads/wk
Reviews
Write oneNobody has reviewed Gfi Scout yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Gfi Scout tools (4)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
check_issue_statusCheck whether a specific GitHub issue is actually available to work on.
check_repo_healthAnalyse a repository's contributor-friendliness.
find_issuesFind beginner-friendly open source issues ranked by likelihood of success.
get_contribution_guidePull and summarise a repo's contribution guide + setup instructions.
Public scan report
scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it
- Code scan28 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 22 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Gfi Scout compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 92/100
- higher than 95% of 48,255 servers
- Tools
- 4
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 17
- more than 5% of 12,191 servers with a package
What its tools let an agent do: 4 read
Install Gfi Scout in Claude Code, Cursor or VS Code
claude mcp add gfi-scout -- uvx gfi-scout
What the publisher says
From the Gfi Scout repository's README, as published. We do not edit it. Read it on GitHub
GFI Scout
An MCP server and standalone CLI that finds open source issues where beginners actually succeed — not just any issue tagged good first issue.
<!-- Official MCP Registry identifier — verifies PyPI package ownership. --> mcp-name: io.github.Rajveerx11/gfi-scout
Why this exists
Most "good first issue" finders are glorified GitHub search wrappers. They happily hand you issues from abandoned repos, issues already claimed by three other contributors, and issues maintainers will never review.
GFI Scout ranks results by likelihood of success — repo health, merge rate, maintainer responsiveness, issue freshness, and setup complexity all feed a composite beginnerscore (0-100). The dead repos sink to the bottom.
It ships as a Model Context Protocol server, plus a standalone CLI/TUI for terminal-first workflows.
Features
- 🔎 findissues** — repo-first language + topic + star-range discovery with scored issue results
- 🩺 checkrepohealth — merge rate, last commit, CONTRIBUTING/CoC/CI probes → A-F grade
- ⏱️ checkissuestatus — assignment, linked PRs, staleness, maintainer confirmation → AVAILABLE / LIKELY_TAKEN / STALE verdict
- 📘 getcontributionguide — pulls and summarises CONTRIBUTING.md, detects toolchain, estimates setup complexity
- Terminal commands via gfi-scout-cli and an interactive gfi-scout-tui
- ⚡ Parallel GitHub API fan-out (asyncio.gather) + per-namespace TTL cache, with opt-in SQLite persistence across sessions
- 🎛️ All scoring weights and thresholds live in src/gfiscout/data/scoringweights.json — no magic numbers in code
- 🧪 100+ tests (unit + integration), mypy --strict clean, ruff clean
Requirements
Quick start
# Clone
git clone https://github.com/Rajveerx11/gfi-scout.git
cd gfi-scout
# Install uv (skip if you have it)
# macOS / Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (PowerShell): irm https://astral.sh/uv/install.ps1 | iex
# Install dependencies (creates .venv automatically)
uv sync
# Optional: add a GitHub token (60 req/h without one, 5,000 req/h with)
cp .env.example .env
# edit .env and paste your GitHub token
# Run the MCP server (stdio transport)
uv run gfi-scout
# Or expose a local Streamable HTTP MCP endpoint
uv run gfi-scout --transport streamable-http --host 127.0.0.1 --port 8000
# Or use the standalone CLI/TUI
uv run gfi-scout-cli find python --min-stars 500
uv run gfi-scout-tuiInstall as a global uv tool
If you only want to run the MCP server / CLI and don't plan to hack on the code, install it once as a global tool. No checkout, no venv to keep around:
# Install (or update) directly from GitHub
uv tool install --force --from git+https://github.com/Rajveerx11/gfi-scout gfi-scoutShortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Gfi Scout: common questions
- Is Gfi Scout MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the Gfi Scout safety report
- How do I install Gfi Scout?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Gfi Scout need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Gfi Scout maintained?
- The last commit was 61 days ago (2026-09-04). The latest release is v0.2.0.
- How does Gfi Scout compare with other MCP servers?
- safety score 92/100 (higher than 95% of 48,255 servers); tools 4 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.