GitHub MCP Server

A FastMCP server that provides access to GitHub repositories and data for Poke integration.

🚀 Features

get_repos: Get repositories for a GitHub user
get_issues: Get issues for a repository
get_pull_requests: Get pull requests for a repository
search_code: Search for code on GitHub

🔑 GitHub Token Setup

This server requires a GitHub personal access token for API access:

Go to GitHub Settings > Personal Access Tokens
Generate a new token with repo and public_repo scopes
Set the environment variable: export GITHUB_TOKEN=your_token_here

🛠️ Local Development

# Install dependencies pip install -r requirements.txt # Set GitHub token export GITHUB_TOKEN=your_token_here # Run the server python src/server.py

🚢 Deployment

Deploy to Render

Steps:

Click the "Deploy to Render" button above or go to render.com
Connect your GitHub account to Render (if you haven't already)
Create a new Web Service:
- Connect this repository
- Name: github-mcp
- Environment: Python 3
- Plan: Free
- Build Command: pip install -r requirements.txt
- Start Command: python src/server.py
Set environment variable:
- Go to your Render service dashboard
- Click on "Environment" tab
- Add environment variable: GITHUB_TOKEN = your_github_token_here
- Click "Save Changes"
Deploy!

Note: On Render's free tier, services go idle after ~15 minutes of inactivity and may require a manual "Deploy" to wake or to pick up the latest commit. Unlike Vercel, pushes do not auto-deploy by default.

Your server will be available at https://github-mcp.onrender.com/mcp

🎯 Poke Integration

Go to poke.com/settings/connections
Add the MCP URL: https://github-mcp.onrender.com/mcp
Give it a name like "GitHub"
Try: "Can you use the GitHub MCP to list my repos?"

References

Based on the Interaction MCP server template: MCP Server Template
Discovered via Interaction’s HackMIT challenge: Interaction HackMIT Challenge

🔧 Available Tools

get_repos(username, limit=10): Get repositories for a user
get_issues(owner, repo, state="open", limit=10): Get issues for a repository
get_pull_requests(owner, repo, state="open", limit=10): Get PRs for a repository
search_code(query, language="", limit=10): Search for code

📝 Example Usage

# Get user's repositories get_repos(username="octocat", limit=5) # Get open issues get_issues(owner="microsoft", repo="vscode", state="open", limit=10) # Get pull requests get_pull_requests(owner="facebook", repo="react", state="open", limit=5) # Search for Python code search_code(query="machine learning", language="python", limit=10)