GitHub MCP Integration

Guide for integrating GitHub repository management with PraisonAI agents using MCP

Add GitHub Tool to AI Agent

Diagram

Query

AI Agent

GitHub MCP

Answer

Quick Start

  1. Install Dependencies

    Make sure you have Node.js installed, as the MCP server requires it:

    bash
    pip install praisonaiagents mcp
  2. Set API Key

    Set your GitHub Personal Access Token as an environment variable in your terminal:

    bash
    export GITHUB_PERSONAL_ACCESS_TOKEN=your_github_token_here
    export OPENAI_API_KEY=your_openai_api_key_here
  3. Create a file

    Create a new file github_agent.py with the following code:

    python
    from praisonaiagents import Agent, MCP
    import os
    
    # Use the API key from environment or set it directly
    github_token = os.getenv("GITHUB_PERSONAL_ACCESS_TOKEN")
    
    # Use a single string command with environment variables
    github_agent = Agent(
        instructions="""You are a helpful assistant that can interact with GitHub.
        Use the available tools when relevant to answer user questions.""",
        llm="gpt-4o-mini",
        tools=MCP("npx -y @modelcontextprotocol/server-github", 
                env={"GITHUB_PERSONAL_ACCESS_TOKEN": github_token})
    )
    
    github_agent.start("List my GitHub repositories")
  4. Run the Agent

    Execute your script:

    bash
    python github_agent.py