Git MCP Server

Git MCP Server

A clean, modular Git MCP server supporting both GitHub and GitLab.

Quick Start

Claude Desktop Configuration

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

GitHub

{

"mcpServers": { "git": { "command": "npx", "args": ["-y", "@raytien/git-mcp-server"], "env": { "GIT_PROVIDER": "github", "GIT_TOKEN": "[PopNx MCP ตัดค่าที่หน้าตาเหมือนกุญแจออก]" } } } }

GitHub Enterprise

{

"mcpServers": { "git": { "command": "npx", "args": ["-y", "@raytien/git-mcp-server"], "env": { "GIT_PROVIDER": "github", "GIT_API_URL": "https://github.your-company.com/api/v3", "GIT_TOKEN": "[PopNx MCP ตัดค่าที่หน้าตาเหมือนกุญแจออก]" } } } }

GitLab.com (SaaS)

{

"mcpServers": { "git": { "command": "npx", "args": ["-y", "@raytien/git-mcp-server"], "env": { "GIT_PROVIDER": "gitlab", "GIT_TOKEN": "glpat-xxxxxxxxxxxxxxxxxxxx" } } } }

Self-Hosted GitLab

{

"mcpServers": { "git": { "command": "npx", "args": ["-y", "@raytien/git-mcp-server"], "env": { "GIT_PROVIDER": "gitlab", "GIT_API_URL": "https://gitlab.your-company.com/api/v4", "GIT_TOKEN": "glpat-xxxxxxxxxxxxxxxxxxxx" } } } }

Read-Only Mode

{

"mcpServers": { "git": { "command": "npx", "args": ["-y", "@raytien/git-mcp-server"], "env": { "GIT_PROVIDER": "github", "GIT_TOKEN": "[PopNx MCP ตัดค่าที่หน้าตาเหมือนกุญแจออก]", "GIT_READ_ONLY": "true" } } } }

Get Your Token

GitHub

1. Go to GitHub > Settings > Developer settings > Personal access tokens > Tokens (classic)
2. Generate new token with scopes: repo, read:org, workflow
3. Copy the token (starts with ghp_)

GitLab

1. Go to GitLab > Settings > Access Tokens
2. Create a new token with scopes: api, read_api, read_repository, write_repository
3. Copy the token (starts with glpat-)

Available Tools

Repository

Issues

Pull/Merge Requests

CI/CD (Pipelines / Workflow Runs)

Note: GitHub Actions workflow runs map to GitLab pipelines. The same tools work for both platforms.

Comments

Users

Configuration

Architecture

src/

├── index.ts # Entry point ├── server.ts # MCP server (provider-agnostic) ├── config.ts # Configuration (multi-provider) ├── providers/ # Platform abstraction │ ├── interface.ts # GitProvider interface │ ├── types.ts # Platform-agnostic types │ ├── config.ts # Provider configuration │ ├── factory.ts # Provider Factory (creates GitLab/GitHub) │ ├── gitlab/ # GitLab implementation │ └── github/ # GitHub implementation ├── tools/ # Tool definitions │ ├── define.ts # defineTool helper │ ├── registry.ts # Tool registry │ ├── repository/ # Repository tools │ ├── issues/ # Issue tools │ ├── merge-requests/ # PR/MR tools │ ├── pipelines/ # CI/CD tools │ ├── notes/ # Comment tools │ └── users/ # User tools ├── gitlab/ # GitLab API client │ ├── client.ts # HTTP client │ └── types.ts # GitLab API types ├── github/ # GitHub API client │ ├── client.ts # HTTP client │ └── types.ts # GitHub API types ├── auth/ # Authentication └── lib/ # Utilities

Development

# Install dependencies

npm install

Build

npm run build

Run tests

npm test

Run locally

npm start

Development mode (watch)

npm run dev

Adding a New Tool

1. Create file: src/tools/{category}/{action}.ts

import { z } from 'zod';

import { defineTool, repoParam } from '../define.js';

const schema = z.object({ repo: repoParam, // ... your params });

export const myTool = defineTool({ name: 'my_tool', description: 'What this tool does', schema, category: 'my-category', read_only: true, handler: async (input, ctx) => { return ctx.provider.repository.someMethod(input.repo, ...); }, });

1. Export from category index: src/tools/{category}/index.ts
2. Add to allTools: src/tools/index.ts

Inspired By

• gitlab-mcp - GitLab MCP server
• github-mcp-server - Official GitHub MCP server

License

MIT