📌Overview

Purpose: To provide LLMs with the capability to utilize GitHub issues as task descriptions through a dedicated MCP server.

Overview: The MCP GitHub Issue Server enables large language models to access and retrieve details from GitHub issues, making it easier to create tasks based on actual issue content from public repositories.

Key Features:

• Fetch Issue Details: Retrieves GitHub issue information from public repositories without requiring authentication, providing structured data for task generation.

• Structured Response: Returns task data in a clearly defined format, including the issue title, description, and source URL, facilitating seamless integration into various applications.

• MCP Compatibility: Fully integrates with the Model Context Protocol (MCP), ensuring it works smoothly within supported systems.

---

MCP GitHub Issue Server

An MCP server that provides LLMs with the ability to use GitHub issues as the task to complete. This server allows LLMs to fetch GitHub issue details and use them as task descriptions.

Installation

Manual Installation

npx mcp-github-issue

Installing via Smithery

To install MCP GitHub Issue Server for Claude Desktop automatically via Smithery:

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

Usage

As an MCP Server

Add to your MCP configuration:

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

Available Tools

get_issue_task

Fetches GitHub issue details to use as a task.

Input Schema:

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "GitHub issue URL (https://github.com/owner/repo/issues/number)"
    }
  },
  "required": ["url"]
}

Example Usage:

<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>

Response Format:

{
  "task": {
    "title": "Issue Title",
    "description": "Issue Description/Body",
    "source": "https://github.com/owner/repo/issues/123"
  }
}

Features

• Fetches GitHub issue details from public repositories
• No authentication required for public repositories
• Returns structured task data including title, description, and source URL
• Compatible with the Model Context Protocol (MCP)

Development

# Install dependencies
npm install

# Build the project
npm run build

# Run the server locally
npm run serve

# Format code
npm run format

# Run MCP inspector
npm run inspector

License

MIT

Author

Sam McLeod (https://smcleod.net)