MCP Github Issue

🚀 MCP GitHub Issue Server

An MCP server that allows Large Language Models (LLMs) to use GitHub issues as tasks to complete. This server enables LLMs to obtain detailed information about GitHub issues and use them as task descriptions.

🚀 Quick Start

The MCP GitHub Issue Server allows LLMs to leverage GitHub issues as tasks. Below are the installation and usage instructions.

📦 Installation

Manual Installation

npx mcp-github-issue

Installation via Smithery

To automatically install the MCP GitHub Issue Server for Claude Desktop, use Smithery:

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

💻 Usage Examples

As an MCP Server

Add the following content to your MCP configuration:

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

Available Tools

get_issue_task

Get detailed information about a GitHub issue for use as a task.

Input Format:

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

• Retrieve detailed information about GitHub issues from public repositories.
• No authentication is required for public repositories.
• Return structured task data, including title, description, and source URL.
• Compatible with the Model Context Protocol (MCP).

🔧 Technical Details

# Install dependencies
npm install

# Build the project
npm run build

# Run the server locally
npm run serve

# Format the code
npm run format

# Run the MCP inspector
npm run inspector

📄 License

MIT

👨‍💻 Author

Sam McLeod (https://smcleod.net)