# GitHub MCP Server

A Model Context Protocol (MCP) server for interacting with GitHub. This tool allows AI assistants to perform various GitHub operations including repository management, file operations, issue tracking, and more.

## Features

- **Repository Operations**: Create repositories, fork repositories
- **File Operations**: Create, update, and read files, push multiple files in a single commit
- **Issue Management**: Create, update, list, and comment on issues
- **Pull Requests**: Create pull requests
- **Branch Management**: Create branches
- **Search Capabilities**: Search code, repositories, issues, and users
- **Commit History**: List commits

## Setup

### Prerequisites

- Node.js 18 or higher
- A GitHub Personal Access Token with appropriate permissions

### Installation

1. Clone this repository
2. Install dependencies:
   ```
   npm install
   ```
3. Build the project:
   ```
   npm run build
   ```

### Configuration

This MCP server requires a GitHub Personal Access Token to authenticate with the GitHub API. The token should be provided as an environment variable:

```
GITHUB_PERSONAL_ACCESS_TOKEN=your_token_here
```

When deploying with Smithery, the token is configured through the `githubPersonalAccessToken` configuration option.

## Usage

### Running Locally

To run the server locally:

```
GITHUB_PERSONAL_ACCESS_TOKEN=your_token_here node dist/index.js
```

### Deploying with Smithery

This repository includes the necessary configuration files for deploying with Smithery:

- `Dockerfile`: Defines how to build the Docker image for the MCP server
- `smithery.yaml`: Configures how Smithery should start the MCP server

Refer to the [Smithery documentation](https://smithery.ai/docs) for deployment instructions.

## Development

### Building

```
npm run build
```

### Linting

```
npm run lint
```

## License

MIT