io.github.Ray0907/git-mcp-server

Registre officiel Outils de développement

MCP server for GitLab and GitHub

Que pouvez-vous faire avec io.github.Ray0907/git-mcp-server ?

Create file: src/tools/{category}/{action}.ts
Export from category index: src/tools/{category}/index.ts
Add to allTools: src/tools/index.ts

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @raytien/git-mcp-server

Claude Code

claude mcp add git-mcp-server -e 'GIT_PROVIDER=<GIT_PROVIDER>' -e 'GIT_TOKEN=<your git_token>' -e 'GIT_API_URL=<GIT_API_URL>' -e 'GIT_READ_ONLY=<GIT_READ_ONLY>' -- npx -y @raytien/git-mcp-server@0.2.3

Configuration JSON (Claude Desktop, Cursor, VS Code)

{
    "mcpServers": {
        "git-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@raytien/git-mcp-server@0.2.3"
            ],
            "env": {
                "GIT_PROVIDER": "<GIT_PROVIDER>",
                "GIT_TOKEN": "<your git_token>",
                "GIT_API_URL": "<GIT_API_URL>",
                "GIT_READ_ONLY": "<GIT_READ_ONLY>"
            }
        }
    }
}

Variables d'environnement

GIT_PROVIDER Provider type: gitlab or github
GIT_TOKEN obligatoire secret Personal Access Token for GitHub or GitLab
GIT_API_URL API URL for self-hosted instances
GIT_READ_ONLY Disable write operations (true/false)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire

Git MCP Server
Quick Start
Available Tools
Configuration
Architecture
Development
Adding a New Tool
Inspired By
License

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": "ghp_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

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": "ghp_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

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": "ghp_xxxxxxxxxxxxxxxxxxxx",
        "GIT_READ_ONLY": "true"
      }
    }
  }
}

Get Your Token

GitHub

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

GitLab

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

Available Tools

Repository

Tool	Description
`get_file_contents`	Read file content from repository
`get_repository_tree`	List directory structure
`push_files`	Push file changes in a single commit
`create_branch`	Create a new branch
`list_branches`	List repository branches
`list_commits`	List commit history
`search_code`	Search for code in repository

Issues

Tool	Description
`get_issue`	Get a single issue
`list_issues`	List issues
`create_issue`	Create a new issue
`update_issue`	Update an issue

Pull/Merge Requests

Tool	Description
`get_pull_request`	Get a merge request
`list_pull_requests`	List merge requests
`create_pull_request`	Create a merge request
`get_pull_request_diffs`	Get merge request changes
`merge_pull_request`	Merge a merge request

CI/CD (Pipelines / Workflow Runs)

Tool	Description
`get_pipeline`	Get pipeline/workflow run status
`list_pipelines`	List pipelines/workflow runs
`list_pipeline_jobs`	List pipeline jobs/workflow jobs
`get_job_log`	Get job log output

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

Comments

Tool	Description
`create_comment`	Add comment to issue/MR
`list_comments`	List comments

Users

Tool	Description
`get_me`	Get current authenticated user

Configuration

Environment Variable	Required	Default	Description
`GIT_PROVIDER`	No	`gitlab`	Provider type: `gitlab` or `github`
`GIT_TOKEN`	Yes	-	Personal Access Token
`GIT_API_URL`	No	Provider default	API URL (auto-detected from provider)
`GIT_AUTH_TYPE`	No	`bearer`	Auth type: `bearer` or `private-token`
`GIT_READ_ONLY`	No	`false`	Disable write operations
`LOG_LEVEL`	No	`info`	Log level: `debug`, `info`, `warn`, `error`

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

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, ...);
    },
});

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

Inspired By

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

License

MIT

Questions fréquentes

Qu'est-ce que io.github.Ray0907/git-mcp-server ?

MCP server for GitLab and GitHub

Comment installer io.github.Ray0907/git-mcp-server ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add git-mcp-server -e 'GIT_PROVIDER=<GIT_PROVIDER>' -e 'GIT_TOKEN=<your git_token>' -e 'GIT_API_URL=<GIT_API_URL>' -e 'GIT_READ_ONLY=<GIT_READ_ONLY>' -- npx -y @raytien/git-mcp-server@0.2.3. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.Ray0907/git-mcp-server ?

Oui. Il attend GIT_TOKEN, à renseigner dans sa configuration.

io.github.Ray0907/git-mcp-server est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.Ray0907/git-mcp-server ?

Il est publié par Ray0907. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.

Détails du serveur

Référencé dans: Registre MCP officiel
Éditeur: Ray0907
Catégorie: Outils de développement
Exécution: Local
Étoiles GitHub: ★ 0
Licence: MIT
Langage: TypeScript
Dernier commit: 8 déc. 2025
Tickets ouverts: 0
Version: 0.2.3
Publié le: 8 déc. 2025

io.github.Ray0907/git-mcp-server

Serveurs similaires

Kodza Free premium UI components in plain HTML, CSS and vanilla JS, for AI coding assistants.
lvl2player sandbox Post a failing test; a coding agent solves it. Test money is held first, released when ...
CGIS Code Graph Code graph for AI agents: impact, call tracing in Python, TypeScript, Go; opt-in JSON a...
mcp-lint Lint MCP tool schemas for client compatibility and agent recovery.
okffs MCP server connecting Claude Code to GitHub for an issue to branch to PR to close workf...
Memnest Local memory for coding AIs: search past conversations and decisions from the original ...
ljos Local memory, a work tracker and a shell-command guard shared by coding agents on one m...
Cartographer Governance MCP server for agent-maintained knowledge bases (OKF): git-backed writes, se...

Outils de développement