# GitHub MCP SSE Server

A Model Context Protocol (MCP) server that provides GitHub API integration through Server-Sent Events (SSE) transport.

## Prerequisites

- Node.js (v16 or higher)
- npm or pnpm
- GitHub Personal Access Token (for API access)

## Installation

1.  Clone the repository:
    ```bash
    git clone https://github.com/JesusMaster/github-see-mcp-server.git
    cd github-see-mcp-server
    ```

2.  Install dependencies:
    ```bash
    npm install
    # or
    pnpm install
    ```

3.  Create a `.env` file in the root directory with the following content:
    ```
    GITHUB_TOKEN=your_github_token_here
    API_KEY=your-secret-api-key
    MCP_SSE_PORT=3200
    ```

4.  Build the project:
    ```bash
    npm run build
    # or
    pnpm run build
    ```

## Usage

### Starting the Server

```bash
npm run start
# or
pnpm run start
```

### Development Mode

```bash
npm run dev
# or
pnpm run dev
```

### Docker

You can also run the server using Docker.

#### Using Dockerfile

```bash
docker build -t github-see-mcp-server .
docker run -d -p 8080:8080 \
  --name github-see-mcp-server \
  github-see-mcp-server
```

#### Using Docker Compose

Make sure you have a `.env` file created as described in the "Installation" section.

```bash
docker-compose up -d
```

To stop the service, run:

```bash
docker-compose down
```

## Connecting with Claude

To connect to this MCP server with Claude, add the following configuration to your Claude session:

```json
{
    "GITHUB":{
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://{Your domain}/sse",
        "--header",
        "GITHUB_TOKEN:${GITHUB_TOKEN}"
      ],
      "env": {
        "GITHUB_TOKEN": "here your github token"
      }
    }
}
```

## Available GitHub Tools

The server provides tools for managing:

-   Issues
-   Pull Requests
-   Repositories
-   Users

## License

MIT