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.

---

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.