mcpField
O
oss-issues-mcp

oss-issues-mcp

本地服务
github.com/AmrMohamed17版本控制05 周前更新
代码仓库

关于 oss-issues-mcp

oss-issues-mcp 是面向 GitHub Issue 分流的 MCP 服务，适用于需要精简、可操作 Issue 信息的工作流。它会清理模板内容，并仅允许访问明确列出的仓库；目前只有 Issue 获取工具可用。

主要功能

  1. 01获取便于分流的 Issue 字段
  2. 02清理 Issue 模板内容
  3. 03限制访问获准仓库
  4. 04只读 GitHub 访问

适用场景

  1. 01查看不含模板杂项的 Issue
  2. 02将 Issue 访问限制在获准仓库

MCP 相关

向 MCP 客户端提供 GitHub Issue 分流工具。目前可用工具用于获取 Issue；其他列出的工具仍在计划中。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "amrmohamed17-oss-issues": {
      "command": "uvx",
      "args": [
        "oss-issues-mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
启动命令uvx oss-issues-mcp
需要配置的环境变量
GITHUB_TOKEN密钥Fine-grained GitHub personal access token, read-only (public repos: Issues, Metadata, Contents).

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypioss-issues-mcp0.1.1

工具

4

收录的工具列表 · 更新于 2 周前

参数类型必填说明
repostring是允许列表中的 "owner/name"，例如 "mlflow/mlflow"。
numberinteger是issue 编号。

详细介绍

oss-issues-mcp

一个 MCP 服务，提供衍生的、面向问题分流的 GitHub 问题工具，而非 GitHub API 的透传接口。

GitHub 自带的 MCP 服务返回原始 API 响应，而此服务会执行特定任务：移除问题模板框架内容、根据多种信号判断问题是否已有人认领，并从关注列表中过滤出新建且仍未关闭的问题。

工具

工具用途
get_actionable_issue获取问题，移除模板附带内容，仅返回与问题分流相关的字段
(planned) list_new_issues获取关注列表中的新建未关闭问题，不包括拉取请求
(planned) get_claim_status此问题是否已有人处理？（受理人 + 关联的 PR）
(planned) get_repo_contextCONTRIBUTING.md 和问题模板规则

安全性

  • 仓库允许列表 — 服务会拒绝任何未明确允许的仓库。
  • 只读 — 在人工审批关卡对写入操作进行管控之前，不提供任何写入工具。
  • 需要一个细粒度、只读的 GITHUB_TOKEN。

运行

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

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。