https://github.com/sammcj/mcp-github-issue

An MCP server that provides LLMs with the ability to use GitHub issues as tasks
https://github.com/sammcj/mcp-github-issue

Last synced: 19 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/sammcj/mcp-github-issue
• Owner: sammcj
• License: mit
• Created: 2024-12-29T07:58:58.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2024-12-29T08:07:04.000Z (9 months ago)
• Last Synced: 2024-12-29T08:09:29.062Z (9 months ago)
• Language: JavaScript
• Size: 0 Bytes
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• mcp-index - GitHub Issue - Fetch GitHub issue details for use as task descriptions, facilitating integration of issue tracking with language model capabilities. (Task and Project Management)

README

          
# MCP GitHub Issue Server

[![smithery badge](https://smithery.ai/badge/mcp-github-issue)](https://smithery.ai/protocol/mcp-github-issue)

[![smithery badge](https://smithery.ai/badge/mcp-github-issue)](https://smithery.ai/server/mcp-github-issue)

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](https://smithery.ai/server/mcp-github-issue):

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