mcp-github-issue
TypeScript icon, indicating that this package has built-in type declarations

0.1.1 • Public • Published

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

npx -y mcp-github-issue

Usage

As an MCP Server

Add to your MCP configuration:

{
  "mcpServers": {
    "github-issue": {
      "command": "npx",
      "args": ["-y", "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)

Package Sidebar

Install

npm i mcp-github-issue

Weekly Downloads

15

Version

0.1.1

License

MIT

Unpacked Size

13.4 kB

Total Files

6

Last publish

Collaborators

  • sammcj