io.github.AmrMohamed17/oss-issues-mcp
MCP server with derived GitHub issue tools: normalized fetch, new-issue watch, claim status.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
oss-issues-mcpclaude mcp add oss-issues-mcp -e 'GITHUB_TOKEN=<your github_token>' -- uvx oss-issues-mcp==0.1.1
{
"mcpServers": {
"oss-issues-mcp": {
"command": "uvx",
"args": [
"oss-issues-mcp==0.1.1"
],
"env": {
"GITHUB_TOKEN": "<your github_token>"
}
}
}
}
متغيرات البيئة
GITHUB_TOKENإلزامي سري Fine-grained GitHub personal access token, read-only (public repos: Issues, Metadata, Contents).
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
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
| Tool | Purpose |
|---|---|
get_actionable_issue | Fetch an issue, strip template furniture, return only triage-relevant fields |
(planned) list_new_issues | New open issues across a watch-list, pull requests excluded |
(planned) get_claim_status | Is this already being worked on? (assignees + linked PRs) |
(planned) get_repo_context | CONTRIBUTING.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
الأسئلة الشائعة
ما هو io.github.AmrMohamed17/oss-issues-mcp؟
MCP server with derived GitHub issue tools: normalized fetch, new-issue watch, claim status.
كيف أثبّت io.github.AmrMohamed17/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 من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.github.AmrMohamed17/oss-issues-mcp إلى مفتاح API؟
نعم. يتطلب GITHUB_TOKEN، وتضبطها في إعداداته.
هل io.github.AmrMohamed17/oss-issues-mcp مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون io.github.AmrMohamed17/oss-issues-mcp؟
ينشره AmrMohamed17. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.