GitHub MCP Server

A Model Context Protocol (MCP) server that provides GitHub API integration.

Features

• 🔍 Search repositories
• 📁 Get repository details and contents
• 🐛 Create and list issues
• 🏷️ Manage labels and states

Setup

1. Install dependencies:

   npm install
   

2. Create a GitHub Personal Access Token:

   • Go to https://github.com/settings/tokens
   • Click "Generate new token (classic)"
   • Select scopes: repo, read:user
   • Copy the token

3. Configure environment:

   cp .env.example .env
   # Edit .env and add your GitHub token
   

4. Run the server:

   npm start
   

Available Tools

search_repositories

Search for GitHub repositories.

Parameters:

• query (required): Search query
• sort: Sort field (stars, forks, updated)
• order: Sort order (asc, desc)
• per_page: Results per page (max 100)

get_repository

Get details about a specific repository.

Parameters:

• owner (required): Repository owner
• repo (required): Repository name

get_repository_contents

Get contents of a file or directory in a repository.

Parameters:

• owner (required): Repository owner
• repo (required): Repository name
• path (required): Path to file or directory
• ref: Branch, tag, or commit SHA

create_issue

Create a new issue in a repository.

Parameters:

• owner (required): Repository owner
• repo (required): Repository name
• title (required): Issue title
• body: Issue body
• labels: Array of label names

list_issues

List issues in a repository.

Parameters:

• owner (required): Repository owner
• repo (required): Repository name
• state: Issue state (open, closed, all)
• labels: Comma-separated list of labels
• per_page: Results per page (max 100)

Integration with SplitCosts

This GitHub MCP server can be used alongside your SplitCosts project to:

• Track issues related to cost splitting features
• Search for similar open-source projects
• Manage project documentation and collaboration
• Automate GitHub workflows related to your project

Usage Examples

With Claude Desktop

Add this to your Claude Desktop configuration:

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": ["/path/to/github-mcp-server/index.js"]
    }
  }
}

Standalone Testing

echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | node index.js