English Français العربية

io.github.AmrMohamed17/oss-issues-mcp

Official registry Developer tools

MCP server with derived GitHub issue tools: normalized fetch, new-issue watch, claim status.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package oss-issues-mcp
Claude Code 
claude mcp add oss-issues-mcp -e 'GITHUB_TOKEN=<your github_token>' -- uvx oss-issues-mcp==0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "oss-issues-mcp": {
            "command": "uvx",
            "args": [
                "oss-issues-mcp==0.1.1"
            ],
            "env": {
                "GITHUB_TOKEN": "<your github_token>"
            }
        }
    }
}

Environment variables

  • GITHUB_TOKEN required secret Fine-grained GitHub personal access token, read-only (public repos: Issues, Metadata, Contents).

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. oss-issues-mcp
  2. Tools
  3. Security
  4. Run
  5. License

oss-issues-mcp

An MCP server exposing derived, triage-oriented GitHub issue tools — not a passthrough of the GitHub API.

Where GitHub's own MCP server returns raw API responses, this server does task-specific work: stripping issue-template scaffolding, resolving whether an issue is already claimed from multiple signals, and filtering a watch-list of repositories to what is new and open.

Tools

ToolPurpose
get_actionable_issueFetch an issue, strip template furniture, return only triage-relevant fields
(planned) list_new_issuesNew open issues across a watch-list, pull requests excluded
(planned) get_claim_statusIs this already being worked on? (assignees + linked PRs)
(planned) get_repo_contextCONTRIBUTING.md and issue-template rules

Security

  • Repository allowlist — the server refuses any repo not explicitly allowed.
  • Read-only — no write tools exist until a human-approval gate governs them.
  • Requires a fine-grained, read-only GITHUB_TOKEN.

Run

export GITHUB_TOKEN=github_pat_...
uv sync
uv run oss-issues-mcp

License

MIT

Frequently asked questions

What is io.github.AmrMohamed17/oss-issues-mcp?

MCP server with derived GitHub issue tools: normalized fetch, new-issue watch, claim status.

How do I install io.github.AmrMohamed17/oss-issues-mcp?

It runs on your machine. In Claude Code: claude mcp add oss-issues-mcp -e 'GITHUB_TOKEN=<your github_token>' -- uvx oss-issues-mcp==0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.AmrMohamed17/oss-issues-mcp need an API key?

Yes. It expects GITHUB_TOKEN, which you set in its configuration.

Is io.github.AmrMohamed17/oss-issues-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.AmrMohamed17/oss-issues-mcp?

It is published by AmrMohamed17. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.