GitHub See

You operate a GitHub SSE MCP Server that exposes GitHub data and actions through Server-Sent Events. This MCP server enables clients to subscribe to real-time updates for issues, pull requests, repositories, and users, making it easy to build interactive tools and dashboards that react to GitHub events.

How to use

You connect to the MCP server from an MCP client to receive live updates about GitHub data. Start the local server or run it in your preferred environment, then point your client to the server’s SSE endpoint. Use the provided environment variables to authorize access to GitHub APIs and to configure your server runtime. You can also deploy the server via Docker if you prefer containerized execution. When you connect, you can access tools that manage Issues, Pull Requests, Repositories, and Users.

How to install

Prerequisites: Node.js v16 or higher, npm or pnpm, and a GitHub Personal Access Token (for API access). Ensure you have a token with the required scopes for your use case.

Step 1: Prepare your environment. Create a project directory and install dependencies, then configure environment variables.

# Step 1: Set up project
git clone https://github.com/JesusMaster/github-see-mcp-server.git
cd github-see-mcp-server

# Step 2: Install dependencies
npm install
# or
pnpm install

# Step 3: Create environment file
cat > .env << 'EOF'
GITHUB_TOKEN=your_github_token_here
API_KEY=your-secret-api-key
MCP_SSE_PORT=3200
EOF

# Step 4: Build the project
npm run build
# or
pnpm run build

# Step 5: Start the server
npm run start
# or
pnpm run start

Notes and deployment options

Docker users can build and run the server with a container. Use the Dockerfile to build and run, or manage the service with Docker Compose. Ensure your .env file is available to provide the necessary tokens and configuration.

To connect a client like Claude, configure a session that runs the MCP CLI with the SSE URL and carries your GitHub token. This enables the client to subscribe to the GitHub data stream exposed by the server.

Configuration and endpoints

The server exposes an SSE endpoint to clients. You will typically connect to a URL like the following placeholder, which you replace with your domain when deployed:

{
  "GITHUB": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote@latest",
      "https://{Your domain}/sse",
      "--header",
      "GITHUB_TOKEN:${GITHUB_TOKEN}"
    ],
    "env": {
      "GITHUB_TOKEN": "your_github_token_here"
    }
  }
}

Available tools

Issues

Create, update, close, and label issues; subscribe to real-time events related to issues via SSE.

Pull Requests

Watch PRs, comment, merge, and track PR events in real time.

Repositories

List and monitor repository metadata and changes; receive updates about repository events.

Users

Retrieve user information and monitor user-related events.