github-project-mcp

# GitHub Project MCP Server A Model Context Protocol (MCP) server for managing GitHub projects and issues using GitHub's GraphQL API. ## Features - List, create, update, and delete (close) GitHub issues - Create issues with embedded images (upload local files or use URLs) - Add/remove labels and assignees from issues - List GitHub projects (ProjectsV2) - Add/remove issues from projects - Update project item fields (move between columns/status) - Get project items and fields - Get repository labels and user IDs - Full GraphQL API integration for efficient data fetching - Easy-to-use CLI with `gps` command ## Installation ### From PyPI (Recommended) ```bash pip install github-project-mcp ``` ### From Source ```bash git clone <your-repo-url> cd github-project-mcp pip install . ``` ### For Development ```bash pip install -e . ``` ### From Wheel ```bash # Install Python `build` pip install build # Build the wheel python -m build # Install the wheel pip install dist/github_project_mcp-0.1.0-py3-none-any.whl ``` ## Quick Start 1. **Configure your GitHub token:** ```bash gps config --token YOUR_GITHUB_TOKEN ``` 2. **Test the connection:** ```bash gps test ``` 3. **Start the server:** ```bash gps start ``` ## CLI Commands The `gps` command provides a comprehensive interface for managing the MCP server: ### Server Management ```bash # Start the server gps start # Start with specific token gps start --token YOUR_TOKEN # Start as daemon (background process) gps start --daemon # Stop the server Press Ctrl + C # Check server status gps status ``` ### Configuration ```bash # Configure GitHub token gps config --token YOUR_TOKEN # Show current configuration gps config --show # Clear configuration gps config --clear ``` ### Utilities ```bash # Test GitHub API connection gps test # List available MCP tools gps tools ``` ## Integration with AI Coding Assistants ### Setup The `gps` cli needs to be accessible from the system PATH, which typically mean…