Github Projects

🚀 GitHub Project MCP Server

An MCP (Model Context Protocol) server that enables AI agents to create and manage GitHub projects based on Agile Sprints.

✨ Features

• GitHub Projects v2 API: Fully supports GitHub's GraphQL Projects v2 API.
• GitHub Issues: Create, read, and update GitHub issues.
• GitHub Repositories: Retrieve repository details.
• Type Safety: Implemented in TypeScript for maximum type safety.

📦 Installation

Install via Smithery

Automatically install the GitHub Project MCP Server for Claude Desktop via Smithery:

npx -y @smithery/cli install taylor-lindores-reeves/mcp-github-projects --client claude

💻 Usage Examples

Manual Installation

1. Clone this repository:

   git clone https://github.com/taylor-lindores-reeves/mcp-github-projects.git
   cd mcp-github-projects
   

2. Install dependencies:

   bun install
   

3. Create a .env file containing your GitHub token:

   GITHUB_TOKEN=your_github_personal_access_token
   GITHUB_OWNER=your_github_username
   

4. Build the server:

   bun run build
   

5. Configure your MCP client with the following settings:

{
  "mcpServers": {
    "GitHubProjects": {
      "command": "bun",
      "args": [
        "/path/to/your/directory/mcp-github-projects-main/build/index.js"
      ],
      "env": {
        "GITHUB_TOKEN": "your_github_personal_access_token",
        "GITHUB_OWNER": "your_github_username_or_org"
      }
    }
  }
}

📚 Documentation

Environment Variables

GitHub Token Permissions

This MCP server requires a GitHub personal access token (classic) with the following permissions:

• project - Full control of projects
• read:project - Read project information
• repo - Full control of private repositories
• repo:status - Access commit status
• repo_deployment - Access deployment status
• public_repo - Access public repositories
• repo:invite - Access repository invitations
• security_events - Read and write security events

Development

Commands

• Build: bun run build
• Generate GraphQL types: bun run graphql-codegen

Project Structure

This is an MCP server for the GitHub GraphQL API, focusing on Project V2 operations. The codebase provides typed access to GitHub projects via GraphQL.

Available Operations

Projects

• Create, read, update, and delete GitHub projects.
• Manage project fields, items, and status updates.
• Convert draft issues to actual issues.
• Archive and unarchive project items.

Issues

• Get issue details.
• Add issues to projects.

Repositories

• Get repository information.