mcpField
O
oss-issues-mcp

oss-issues-mcp

Local
github.com/AmrMohamed17Version Control0Updated 5w ago
Repository

About oss-issues-mcp

oss-issues-mcp is an MCP server for GitHub issue triage, aimed at workflows that need concise, actionable issue data. It cleans template scaffolding and restricts access to explicitly allowed repositories; only the issue-fetch tool is currently available.

Key features

  1. 01Fetches triage-ready issue fields
  2. 02Removes issue-template scaffolding
  3. 03Restricts access to allowed repositories
  4. 04Read-only GitHub access

Use cases

  1. 01Review an issue without template clutter
  2. 02Limit issue access to approved repositories

MCP support

Exposes GitHub issue triage tools to MCP clients. The current available tool fetches an issue; other listed tools are planned.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "amrmohamed17-oss-issues": {
      "command": "uvx",
      "args": [
        "oss-issues-mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
Run commanduvx oss-issues-mcp
Environment variables to set
GITHUB_TOKENSecretFine-grained GitHub personal access token, read-only (public repos: Issues, Metadata, Contents).

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypioss-issues-mcp0.1.1

Tools

4

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
repostringYes"owner/name" on the allowlist, e.g. "mlflow/mlflow".
numberintegerYesthe issue number.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.