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: 5 months 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 (6 months ago)
- Default Branch: main
- Last Pushed: 2024-12-29T08:07:04.000Z (6 months ago)
- Last Synced: 2024-12-29T08:09:29.062Z (6 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
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
```bash
npx -y mcp-github-issue
```
## Usage
### As an MCP Server
Add to your MCP configuration:
```json
{
"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:**
```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)