金大哥 - mcp-github-issue MCP 详情

article

README

🚀 MCP GitHub 问题服务器

MCP GitHub 问题服务器是一个独特的 MCP 服务器，它允许大语言模型（LLMs）借助 GitHub 问题作为任务来完成。通过该服务器，LLMs 能够获取 GitHub 问题的详细信息，并将其作为任务描述加以利用。

🚀 快速开始

MCP GitHub 问题服务器为大语言模型开启了利用 GitHub 问题进行任务处理的新途径。下面将为您介绍其安装和使用方法。

📦 安装指南

手动安装

您可以使用以下命令进行手动安装：

npx mcp-github-issue

通过 Smithery 安装

若要为 Claude 桌面自动安装 MCP GitHub 问题服务器，可使用 Smithery：

npx -y @smithery/cli install mcp-github-issue --client claude

💻 使用示例

作为 MCP 服务器

将以下内容添加到您的 MCP 配置中：

{
  "mcpServers": {
    "github-issue": {
      "command": "npx",
      "args": ["mcp-github-issue"]
    }
  }
}

可用工具

get_issue_task

此工具可用于获取 GitHub 问题详细信息以作为任务使用。

输入格式：

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "GitHub 问题 URL（https://github.com/owner/repo/issues/number）"
    }
  },
  "required": ["url"]
}

示例用法：

<use_mcp_tool>
<server_name>github-issue</server_name>
<tool_name>get_issue_task</tool_name>
<arguments>
{
  "url": "https://github.com/owner/repo/issues/123"
}
</arguments>
</use_mcp_tool>

响应格式：

{
  "task": {
    "title": "问题标题",
    "description": "问题描述/正文",
    "source": "https://github.com/owner/repo/issues/123"
  }
}

✨ 主要特性

能够从公共仓库获取 GitHub 问题详细信息。
公共仓库无需身份验证，使用更加便捷。
返回结构化任务数据，包含标题、描述和来源 URL，方便大语言模型处理。
与模型上下文协议（MCP）兼容，具备良好的通用性。

🔧 技术细节

开发命令

# 安装依赖项
npm install

# 构建项目
npm run build

# 在本地运行服务器
npm run serve

# 格式化代码
npm run format

# 运行 MCP 检查器
npm run inspector

📄 许可证

本项目采用 MIT 许可证。

👨‍💻 作者

Sam McLeod（https://smcleod.net）

mcp-github-issue