mcp-github-issue

An MCP server that provides LLMs with the ability to use GitHub issues as tasks

14 stars JavaScriptAI & Machine Learning Updated Sep 17, 2025

Documentation

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

bash

npx mcp-github-issue

Installing via Smithery

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

bash

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

Usage

As an MCP Server

Add to your MCP configuration:

json

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

json

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

Example Usage:

typescript

github-issue
get_issue_task

{
  "url": "https://github.com/owner/repo/issues/123"
}

Response Format:

json

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

bash

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

Frequently asked questions

What is mcp-github-issue?

mcp-github-issue is An MCP server that provides LLMs with the ability to use GitHub issues as tasks

How do I install mcp-github-issue?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is mcp-github-issue open source?

Yes — it is hosted on GitHub at https://github.com/sammcj/mcp-github-issue and has 14 stars.

Related MCP tools

anything-llm

The all-in-one Desktop & Docker AI application with built-in RAG, AI agents, No-code agent builder, MCP compatibility, and more.

50,686 JavaScript

ai-agentscustom-ai-agentsdeepseek+16

claude-task-master

An AI-powered task-management system you can drop into Cursor, Lovable, Windsurf, Roo, and others. Built for the Model Context Protocol to enhance AI capabiliti

23,033 JavaScript

aicursorcursor-ai+9

fay

Fay是一个帮助数字人（2.5d、3d、移动、pc、网页）或大语言模型（openai兼容、deepseek）连通业务系统的mcp框架。 JavaScript-based implementation. Trusted by 12000+ developers.

12,003 JavaScript

aiandroidapi+4

cursor-talk-to-figma-mcp

CTTF: MCP integration between Cursor and Figma, allowing Cursor Agentic AI to communicate with Figma for reading designs and modifying them programmatically.

5,539 JavaScript

agentagenticagentic-ai+11

firecrawl-mcp-server

🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients. JavaScript-based implementation.

4,847 JavaScript

batch-processingclaudecontent-extraction+11

desktopcommandermcp

This is MCP server for Claude that gives it terminal control, file system search and diff file editing capabilities JavaScript-based implementation.

4,840 JavaScript

agentaicode-analysis+5

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP