Skip to main content
Glama
EnesOzturk11

Git MCP Server

by EnesOzturk11
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

Git MCP Server

A Model Context Protocol (MCP) server that gives AI assistants the ability to inspect local Git repositories and interact with the GitHub API — reading commit history, diffs, file contents, issues, comments, pull requests, and project boards — all from a single, modular TypeScript server.

Tools

The server exposes 10 tools across four categories.

Git

Tool

Description

get_git_status

Returns all uncommitted changes in a local repository (equivalent to git status).

get_git_log

Retrieves recent commit history with hash, author, date, and message. Accepts a maxCount limit.

get-git-diff

Shows line-by-line file differences. Can be scoped to a specific file or limited to staged changes only.

get_repo_structure

Returns the full directory and file tree of a repository — useful for architectural overviews and documentation.

File System

Tool

Description

read_local_file

Reads the entire content of a small file at once. Ideal for source files and configs.

read_local_file_chunk

Reads a specific line range (startLine–endLine) from a large file, avoiding unnecessary context.

GitHub Issues

Tool

Description

fetch_all_issues

Fetches all issues (open and closed) from a remote GitHub repository.

get_issue_comments

Retrieves all comments on a specific issue by number, including author and timestamps.

create_and_board_issue

Creates a new issue with title, body, labels, assignees, and priority — then automatically adds it to the repository's GitHub Projects board. Handles multi-project repos by prompting for project selection.

GitHub Pull Requests

Tool

Description

fetch_merged_prs

Lists recent pull requests from a repository. Toggle between merged and open PRs with isMerged. Useful for generating changelogs and release notes.

Related MCP server: GitHub MCP Server

Architecture

The server follows a layered, modular design introduced in PR #1:

src/
├── index.ts              # Server bootstrap — wires tools to the MCP server
├── config.ts             # Centralised environment config (GITHUB_TOKEN, cache TTL)
├── services/
│   ├── github-rest.ts    # GitHub REST API client
│   ├── github-graphql.ts # GitHub GraphQL client (used for Projects v2 boarding)
│   ├── cache.ts          # In-memory project metadata cache (1 h TTL)
│   └── git-cmd.ts        # Local Git CLI wrapper
├── tools/
│   ├── git.ts            # Git operation tools
│   ├── filesystem.ts     # File reading tools
│   ├── issues.ts         # GitHub Issue tools
│   └── pulls.ts          # GitHub Pull Request tools
├── types/
│   ├── github.ts         # GitHub API response types
│   ├── cache.ts          # Cache types
│   └── git.ts            # Git operation types
└── utils/
    └── helpers.ts        # Shared utility functions

Requirements

  • Node.js v18 or later

  • GitHub Personal Access Token with repo and project scopes

Installation

# Clone the repository
git clone https://github.com/EnesOzturk11/Git-MCP-Server.git
cd Git-MCP-Server

# Install dependencies
npm install

# Build
npm run build

Configuration

The server reads a single environment variable:

Variable

Required

Description

GITHUB_TOKEN

Yes

Personal Access Token for GitHub API authentication

Create a .env file in the project root or export the variable in your shell:

GITHUB_TOKEN=ghp_your_token_here

Usage with Claude Desktop

Add the server to your Claude Desktop configuration file (claude_desktop_config.json):

{
  "mcpServers": {
    "git-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/Git-MCP-Server/build/index.js"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Restart Claude Desktop — the 10 tools will become available immediately.

Tech Stack

Layer

Technology

Language

TypeScript 5

Runtime

Node.js (ESM)

Protocol

Model Context Protocol SDK ^1.26.0

Validation

Zod ^4.3.6

GitHub API

REST + GraphQL (Projects v2)

Environment

dotenv

Contributing

Issues and pull requests are welcome. Please open an issue first to discuss any significant changes.

This server cannot be installed

F
license - not found
-
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/EnesOzturk11/Git-MCP-Server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server