Git MCP server
✓ 인증됨순수 JavaScript를 사용하여 상태 확인, 로그, diff, 브랜치 및 제한된 커밋을 포함한 로컬 Git 저장소를 AI 클라이언트가 관리할 수 있게 합니다.
다른 이름 Abhishekkumar2021/mcp-suite, @abhishekmcp/git, @abhishekmcp/files
- 스타
- 1
- Tools
- —
- 다운로드, 30일
- 389
- 최신 버전
- 0.2.0
- 마지막 커밋
- 2026년 7월 4일
- 라이선스
- MIT
Git MCP란?
Git은(는) MCP server입니다. 순수 JavaScript를 사용하여 상태 확인, 로그, diff, 브랜치 및 제한된 커밋을 포함한 로컬 Git 저장소를 AI 클라이언트가 관리할 수 있게 합니다.
프로젝트 README에서 생성된 요약
Git MCP server 정보
이 server는 개발자가 AI 클라이언트를 통해 로컬 버전 관리 시스템을 직접 관리할 수 있도록 지원합니다. 순수 JavaScript를 사용하여 Git 저장소와 상호작용하므로, 작동을 위해 로컬 git binary가 필요하지 않습니다. 덕분에 Claude Desktop, Claude Code 또는 Cursor와 같은 클라이언트에 연결할 때 다양한 환경에서 높은 이식성을 제공합니다.
사용자는 상태 확인, 로그 보기, diff 검사, 브랜치 및 태그 관리 등 다양한 저장소 관리 작업을 수행할 수 있습니다. 또한 clone, fetch, pull, push와 같은 remote 작업도 지원합니다. 개발 프로세스 중 안전을 보장하기 위해, 실수로 인한 변경을 방지하는 gated stage 및 commit 도구가 포함되어 있습니다. 이 패키지는 독립적인 npm 패키지로 배포되어 npx 또는 MCPB 번들을 통해 기존 워크플로우에 쉽게 통합할 수 있습니다.
활용 사례
- 1저장소 변경 사항 검사AI가 프로젝트의 현재 상태를 조사하고 특정 코드의 차이점을 확인할 수 있습니다.
- 2버전 관리 히스토리 관리개발자는 AI에게 커밋 히스토리를 검토하거나 기존 브랜치 목록을 요청할 수 있습니다.
- 3원격 저장소 작업 수행클라이언트가 업데이트를 pull 하거나 새로운 코드를 remote에 push 하는 등의 동기화 작업을 처리할 수 있습니다.
- 4제어된 커밋 실행보호된 워크플로우를 사용하여 AI에게 파일을 stage하고 commit 하도록 지시할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Git MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Git MCP 설치
$ claude mcp add --env 'GIT_ROOTS=<GIT_ROOTS>' git -- npx -y @abhishekmcp/gitCursor에 Git MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"git": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/git"
],
"env": {
"GIT_ROOTS": "<GIT_ROOTS>"
}
}
}
}VS Code에 Git MCP 설치
.vscode/mcp.json
{
"servers": {
"git": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@abhishekmcp/git"
],
"env": {
"GIT_ROOTS": "<GIT_ROOTS>"
}
}
}
}VS Code CLI에 Git MCP 설치
$ code --add-mcp '{"name":"git","type":"stdio","command":"npx","args":["-y","@abhishekmcp/git"],"env":{"GIT_ROOTS":"<GIT_ROOTS>"}}'Claude Desktop에 Git MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"git": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/git"
],
"env": {
"GIT_ROOTS": "<GIT_ROOTS>"
}
}
}
}Codex에 Git MCP 설치
$ codex mcp add git --env 'GIT_ROOTS=<GIT_ROOTS>' -- npx -y @abhishekmcp/gitCodex config.toml에 Git MCP 설치
~/.codex/config.toml
[mcp_servers.git] command = "npx" args = ["-y", "@abhishekmcp/git"] [mcp_servers.git.env] GIT_ROOTS = "<GIT_ROOTS>"
Gemini CLI에 Git MCP 설치
$ gemini mcp add -s user -e 'GIT_ROOTS=<GIT_ROOTS>' git npx -- -y @abhishekmcp/gitGemini settings.json에 Git MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"git": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/git"
],
"env": {
"GIT_ROOTS": "<GIT_ROOTS>"
}
}
}
}구성
GIT_ROOTS필수Allowed repo root directories (comma-separated). Required — the server refuses to start without it.
GIT_WRITABLESet to 1 or true to enable local write tools (stage/commit/branch/checkout).
NOTES_DIR
| 이름 | 설명 | 유형 |
|---|---|---|
| GIT_ROOTS | Allowed repo root directories (comma-separated). Required — the server refuses to start without it. | 필수 |
| GIT_WRITABLE | Set to 1 or true to enable local write tools (stage/commit/branch/checkout). | |
| NOTES_DIR | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능abhishekkumar2021/mcp-suite is public and reachablegithub.com/abhishekkumar2021/mcp-suite ↗통과
- 패키지가 이 저장소를 소스로 명시@abhishekmcp/git, @abhishekmcp/files name abhishekkumar2021/mcp-suite as sourcenpmjs.com/package/@abhishekmcp/git ↗통과
- 빌드 출처(Sigstore 증명)Sigstore attestation for @abhishekmcp/git, @abhishekmcp/filesnpmjs.com/package/@abhishekmcp/git/v/0.2.0#provenance ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-07-04github.com/abhishekkumar2021/mcp-suite ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @abhishekmcp/git, @abhishekmcp/files통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음130 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기🧰 mcp-suite
A collection of Model Context Protocol servers, built in TypeScript.
Each server lives in its own folder under servers/ and publishes to npm as an independent package, while sharing tooling through an npm workspace. Connect them to any MCP client — Claude Desktop, Claude Code, Cursor, and more.
Table of contents
- Servers
- Quickstart
- Install
- Connecting to a client
- Architecture & conventions
- Development
- Adding a new server
- Publishing
- Contributing
- License
Servers
| Server | Description | Status |
|---|---|---|
notes |
Local markdown notes: ranked full-text and semantic search, tags, todos, a [[wiki-link]] knowledge graph, daily notes + templates, and slash-command workflows (prompts) |
✅ Stable |
files |
Sandboxed local filesystem: read, glob + content search, token-efficient edits, copy/move, soft-delete trash, zip, checksums, and dedup | ✅ Stable |
github |
GitHub: search repos/code/issues, read repos/issues/PRs/files, notifications, create issues — OAuth device flow or token | ✅ Stable |
git |
Git: status, log, diff, file history, branches/tags, gated stage/commit, and remote clone/fetch/pull/push — pure-JS, no git binary | ✅ Stable |
sql |
SQL databases: read-only query + schema introspection over Postgres & SQLite, gated writes | ✅ Stable |
http |
HTTP/REST client: ad-hoc requests + saved collections/environments, env secrets, host-allowlisted + SSRF-safe | ✅ Stable |
More on the way: a Spotify controller, and others.
Quickstart
git clone https://github.com/Abhishekkumar2021/mcp-suite.git
cd mcp-suite
npm install # installs deps for every workspace
npm run build # builds every server
Install
Every server ships through every common channel. For the Claude Code plugin, add the marketplace
once — /plugin marketplace add Abhishekkumar2021/mcp-suite — then install per the table. See each
server's README for full config.
| Server | Claude Code plugin | npm (any client) | Claude Desktop (MCPB) | MCP registry |
|---|---|---|---|---|
notes |
/plugin install notes |
npx -y @abhishekmcp/notes |
drag notes-*.mcpb from the latest release |
io.github.Abhishekkumar2021/notes |
files |
/plugin install files |
npx -y @abhishekmcp/files |
drag files-*.mcpb |
io.github.Abhishekkumar2021/files |
github |
/plugin install github |
npx -y @abhishekmcp/github |
drag github-*.mcpb |
io.github.Abhishekkumar2021/github |
git |
/plugin install git |
npx -y @abhishekmcp/git |
drag git-*.mcpb |
io.github.Abhishekkumar2021/git |
sql |
/plugin install sql |
npx -y @abhishekmcp/sql |
drag sql-*.mcpb |
io.github.Abhishekkumar2021/sql |
http |
/plugin install http |
npx -y @abhishekmcp/http |
drag http-*.mcpb |
io.github.Abhishekkumar2021/http |
notesdefaults to~/notes;filesrequiresFS_ROOTS(the directories it may touch). MCPB bundles install via Claude Desktop → Settings → Extensions.
Connecting to a client
Each server's README has full configuration instructions. As an example, to use the notes server with Claude Code:
claude mcp add notes --env NOTES_DIR=$HOME/notes -- node "$(pwd)/servers/notes/dist/index.js"
Or with Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"notes": {
"command": "node",
"args": ["/absolute/path/to/mcp-suite/servers/notes/dist/index.js"],
"env": { "NOTES_DIR": "/absolute/path/to/your/notes" }
}
}
}
Architecture & conventions
A few principles hold across every server:
- Pure-JS/WASM by default; native only when genuinely required. Servers run via
npx/MCPB on any machine, so portable pure-JS/WebAssembly is strongly preferred and a native dependency is used only when genuinely required (gated + documented). In practice these servers are dependency-light:notesuses MiniSearch + WebAssembly embeddings,sqluses thesql.jsWASM SQLite engine, andfilesusesfast-globinstead of ripgrep.npm auditstays clean. - Sandbox-first, layered design. Each server keeps a thin
index.ts(tool registration only) over focused modules, with a single security boundary every path must pass through (realpath-containment, symlink-escape rejection, atomic writes). - Token-efficient by default. Pagination, head/tail/section reads, snippets, and compact graph refs keep tool output small.
- Automated, hands-off releases. A GitHub Release tagged
<server>-v<version>publishes to npm (with provenance), the official MCP registry, and attaches an MCPB bundle — all via OIDC, no secrets. - Tested in CI. Each server ships a committed
node:testsuite (unit + integration/security) run on every push.
Development
This is an npm workspaces monorepo.
npm install # install all workspace dependencies (run once at the root)
npm run build # build every server
npm run build -w servers/notes # build a single server
npm test --workspaces --if-present # run each server's test suite
npm run clean # remove all build output
Adding a new server
- Create
servers/<name>/with its ownpackage.json(unique npmname) and atsconfig.jsonthatextends: "../../tsconfig.base.json". - Put source in
servers/<name>/src/. - Run
npm installat the root so the workspace picks it up. - Add a row to the Servers table above.
All servers follow the naming standard (@abhishekmcp/<slug>). See CONTRIBUTING.md for detailed guidelines.
Publishing
Releases are automated. Cutting a GitHub Release tagged <server>-v<version> triggers
publish.yml, which — authenticated entirely via GitHub OIDC (no
NPM_TOKEN) — publishes the package to npm with provenance, registers it on the official MCP
registry, and builds + attaches the MCPB bundle to the release.
# bump servers/<name>/package.json, commit, then:
gh release create <name>-v<version> --title "<name> v<version>" --notes "…"
Contributing
Contributions are welcome! Please read CONTRIBUTING.md and our Code of Conduct. Found a security issue? See SECURITY.md.
License
MIT © Abhishek
Git MCP 질문
Git MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'GIT_ROOTS=<GIT_ROOTS>' git -- npx -y @abhishekmcp/git를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Git MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
이 Git server를 사용하려면 로컬에 Git binary가 설치되어 있어야 하나요?
아니요, 이 server는 순수 JavaScript로 작성되었으므로 작동을 위해 Git binary가 필요하지 않습니다.
이 server를 통해 AI가 어떤 Git 작업을 수행할 수 있나요?
상태 확인, 로그 및 diff 보기, 파일 히스토리 및 브랜치/태그 검사, 제한된 staging 및 commit 수행, 그리고 clone, fetch, pull, push를 통한 remote 관리 기능을 지원합니다.
Git MCP server를 어떻게 설치하나요?
npx -y @abhishekmcp/git 명령어를 통해 npm으로 설치하거나 Claude Code 플러그인을 추가하여 설치할 수 있습니다.