Happy slice of mcp pizzaMCP.pizza
Fire in da houseTop Tip:Paying $100+ per month for Perplexity, MidJourney, Runway, ChatGPT and other tools is crazy - get all your AI tools in one site starting at $15 per month with Galaxy AI Fire in da houseCheck it out free

mcp-github-issue

MCP.Pizza Chef: sammcj

The MCP GitHub Issue Server is a specialized MCP server that empowers large language models (LLMs) to interact directly with GitHub issues. By exposing GitHub issue details as structured tasks, it allows LLMs to fetch, understand, and act upon issue descriptions seamlessly. This integration facilitates automated task management, issue tracking, and project collaboration within AI-enhanced workflows. Installation is straightforward via npm or Smithery CLI, making it easy to incorporate into existing MCP configurations. It supports real-time task retrieval from GitHub, enabling models to work with up-to-date project issues for efficient task completion and context-aware assistance.

Use This MCP server To

Fetch GitHub issue details for AI task automation Enable LLMs to track and update project issues Integrate GitHub issues into AI-driven workflows Automate issue summarization and status reporting Use GitHub issues as structured prompts for LLMs

README

MCP GitHub Issue Server

smithery badge

smithery badge

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.

GitHub Issue Server MCP server

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)

mcp-github-issue FAQ

How do I install the MCP GitHub Issue Server?
You can install it manually using 'npx mcp-github-issue' or automatically via Smithery CLI with 'npx -y @smithery/cli install mcp-github-issue --client claude'.
Can this server be used with LLMs other than Claude?
Yes, it is compatible with various LLM providers including OpenAI, Claude, and Gemini, as it follows the MCP protocol standards.
How does the server authenticate with GitHub?
Authentication typically requires a GitHub token configured in your environment or MCP client settings to securely access issue data.
Is it possible to fetch issues from private repositories?
Yes, provided the authentication token has the necessary permissions to access private repositories.
How do I configure the MCP client to use this server?
Add the MCP GitHub Issue Server to your MCP configuration JSON under the servers section, specifying repository and authentication details as needed.
Does the server support real-time updates of GitHub issues?
The server fetches current issue data on request, enabling near real-time access depending on polling or event-driven triggers configured in your MCP client.
Can the server modify GitHub issues or only read them?
Primarily, it provides read access to issue details for task use, but with appropriate permissions and extensions, it may support issue updates.
What formats are GitHub issue details provided in?
Issue data is exposed in structured JSON format, including title, description, labels, status, and comments for comprehensive context.