What is Mcp Server Github Projects

mcp-server-github-projects is a Model Context Protocol server implementation designed for the GitHub Projects API, enabling management of project views, priorities, dependencies, and metrics.

Use cases

Use cases include managing project workflows, tracking item priorities, analyzing dependencies among project items, and generating performance metrics for project management.

How to use

To use mcp-server-github-projects, install it via npm with ‘npm install @terraco89/mcp-server-github-projects’, configure the GITHUB_TOKEN environment variable, and integrate it into your application either as a library, CLI, or through Docker/NPX commands.

Key features

Key features include creating, updating, and deleting project views, assessing and updating item priorities, managing item dependencies, and generating project metrics.

Where to use

mcp-server-github-projects can be used in software development environments where GitHub Projects are utilized for project management and tracking.

MCP Server GitHub Projects

A Model Context Protocol server implementation for the GitHub Projects API. This package provides operations for managing GitHub Project views, priorities, dependencies, and metrics.

Installation

npm install @terraco89/mcp-server-github-projects

Configuration

Set the following environment variables:

GITHUB_TOKEN=your_github_personal_access_token

The token needs the following permissions:

• project (read/write)
• repo (read)

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

Docker

{
  "mcpServers": {
    "github-projects": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_TOKEN",
        "mcp/github-projects"
      ],
      "env": {
        "GITHUB_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "github-projects": {
      "command": "npx",
      "args": [
        "-y",
        "@terraco89/mcp-server-github-projects"
      ],
      "env": {
        "GITHUB_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Usage as a Library

import { server } from '@terraco89/mcp-server-github-projects';

// Start the server
server.listen();

Usage as a CLI

mcp-server-github-projects

Available Operations

Project Views

• createProjectView - Create a new view in a GitHub Project
• updateProjectView - Update an existing view
• deleteProjectView - Delete a view
• listProjectViews - List all views in a project

Priorities

• assessItemPriority - Assess and update item priority
• batchUpdatePriorities - Update multiple item priorities

Dependencies

• manageItemDependencies - Manage item dependencies
• analyzeDependencies - Analyze project dependencies

Metrics

• generateProjectMetrics - Generate project metrics

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run watch

Build

Docker build:

docker build -t mcp/github-projects -f Dockerfile .

License

MIT