What is Mcp Github Issue

The mcp-github-issue is an MCP server that enables Large Language Models (LLMs) to utilize GitHub issues as tasks to complete. It allows LLMs to fetch details of GitHub issues and use them as task descriptions.

Use cases

Use cases for mcp-github-issue include automating task management by integrating GitHub issues into workflows, enhancing LLM capabilities in handling software development tasks, and providing context-aware responses based on GitHub issues.

How to use

To use mcp-github-issue, you need to add it to your MCP configuration. You can install it manually using ‘npx mcp-github-issue’ or automatically via Smithery with ‘npx -y @smithery/cli install mcp-github-issue --client claude’. Use the ‘get_issue_task’ tool to fetch issue details by providing the GitHub issue URL.

Key features

Key features include fetching GitHub issue details from public repositories without requiring authentication, returning structured task data such as title, description, and source URL, and compatibility with the Model Context Protocol (MCP).

Where to use

undefined

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)