GitHub Projects
This project provides an MCP server for scraping data from GitHub Projects. For use on private projects you will need a Github Personal Access Token (PAT) with the following permissions:
Repository permissions:
- Contents: Read-only
- Issues: Read-only
- Metadata: Read-only
- Pull requests: Read-only
Organization permissions:
- Members: Read-only
- Projects: Read-only
Running with MCP
In Claude Desktop:
vim ~/Library/Application\ Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"github-projects": {
"command": "uv",
"args": [
"--directory",
"/Users/jamesbriggs/Documents/aurelio/corp-agent/github-projects",
"run",
"github_projects/mcp/app.py"
]
"env": {
"GITHUB_PAT": "github_pat_..."
}
}
}
}
Digging in
We're leaving some quick notes on working and developing with MCP here. First, to view your MCP server and the various tools etc it contains we recommend:
npm install -g @modelcontextprotocol/inspector
Start the inspector app, inside the terminal you should see a localhost URL you can navigate to to open the UI.
mcp-inspector
Once inside the UI, start and connect to the MCP server with the following adapted to your particular environment. Note that these are the same inputs we provide to Claude Desktop:
Command: uv
Arguments: --directory /Users/jamesbriggs/Documents/aurelio/corp-agent/github-projects run python -m github_projects.app
Environment Variables (keep anything already here, just append): GITHUB_PAT: github_pat_...
Assuming the server started successfully, you can navigate to Tools and view the @mcp.tool methods that we have defined.