GitHub Projects Server

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