GitHub MCP Client

A TypeScript client for interacting with GitHub using the Model Context Protocol (MCP) and the Vercel AI SDK with Gemini.

Features

• MCP Integration: Connects to the GitHub MCP server to perform GitHub operations
• AI-Powered: Uses the Gemini model to process natural language queries
• CLI Interface: Provides a command-line interface for interacting with the agent
• Interactive Mode: Supports an interactive chat-like interface

Prerequisites

• Node.js 18 or later
• GitHub Personal Access Token
• Google Gemini API Key

Installation

1. Clone the repository:

git clone https://github.com/yourusername/github-mcp-client.git
cd github-mcp-client

2. Install dependencies:

npm install

3. Create a .env file with your API keys:

GITHUB_TOKEN=your_github_personal_access_token
GEMINI_API_KEY=your_gemini_api_key

4. Build the project:

npm run build

Usage

CLI Commands

Query Mode

Process a single query:

npm start -- query "Search for repositories related to TypeScript MCP"

Interactive Mode

Start an interactive session:

npm start -- interactive

Or use the shorthand:

npm start -- i

API Usage

You can also use the GitHub MCP client programmatically:

import { GitHubAgent } from 'github-mcp-client';

async function main() {
  // Create a GitHub agent
  const agent = new GitHubAgent(
    'your_github_token',
    'your_gemini_api_key'
  );

  try {
    // Process a query
    const response = await agent.processQuery(
      'Search for repositories related to TypeScript MCP'
    );
    console.log(response);
  } finally {
    // Close the agent
    await agent.close();
  }
}

main().catch(console.error);

Available GitHub Operations

The GitHub MCP client supports the following operations:

• Create a repository
• Search for repositories
• Get file contents
• Create or update files
• Push multiple files
• Create issues
• Create pull requests
• Create branches
• Search code, issues, and users

Development

Project Structure

github-mcp-client/
├── src/
│   ├── client/         # MCP client implementation
│   ├── agent/          # AI agent implementation
│   ├── cli/            # CLI interface
│   ├── config/         # Configuration management
│   └── index.ts        # Main entry point
├── dist/               # Compiled JavaScript
├── .env                # Environment variables
├── tsconfig.json       # TypeScript configuration
└── package.json        # Project metadata

Scripts

• npm run build: Build the project
• npm start: Run the CLI
• npm run dev: Run the CLI in development mode

License

MIT