MCP server Git
✓ VerificadoPermite que um cliente de IA gerencie repositórios Git locais, incluindo status, logs, diffs, branches e commits controlados, usando apenas JavaScript.
Também conhecido como Abhishekkumar2021/mcp-suite, @abhishekmcp/git, @abhishekmcp/files
- Stars
- 1
- Ferramentas
- —
- Downloads, 30 dias
- 389
- Versão mais recente
- 0.2.0
- Último commit
- 4 de jul. de 2026
- Licença
- MIT
O que é o MCP Git?
Permite que um cliente de IA gerencie repositórios Git locais, incluindo status, logs, diffs, branches e commits controlados, usando apenas JavaScript.
Resumo gerado a partir do README do projeto
Sobre o MCP server de Git
Gerenciar o controle de versão local diretamente através de um cliente de IA é o que este servidor possibilita para os desenvolvedores. Ele oferece uma maneira de interagir com repositórios Git usando apenas JavaScript, o que significa que não requer um binário git local para funcionar. Isso o torna altamente portátil entre diferentes ambientes quando conectado a clientes como Claude Desktop, Claude Code ou Cursor.
Os usuários podem realizar uma variedade de tarefas de gerenciamento de repositório, incluindo verificar o status, visualizar logs, inspecionar diffs e gerenciar branches ou tags. O servidor também suporta operações remotas como clone, fetch, pull e push. Para garantir a segurança durante o processo de desenvolvimento, ele inclui ferramentas de stage e commit controlados para evitar alterações acidentais. Ele é distribuído como um pacote npm independente, facilitando a integração em fluxos de trabalho existentes via npx ou pacotes MCPB.
O que você pode fazer com ele
- 1Inspecionar mudanças no repositórioUma IA pode examinar o estado atual de um projeto e visualizar diferenças específicas no código.
- 2Gerenciar o histórico de controle de versãoDesenvolvedores podem pedir a uma IA para revisar o histórico de commits ou listar as branches existentes.
- 3Realizar operações de repositório remotoO cliente pode lidar com tarefas de sincronização, como pull de atualizações ou push de novo código para um remoto.
- 4Executar commits controladosVocê pode instruir uma IA a realizar o stage e o commit de arquivos usando um fluxo de trabalho protegido.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP Git
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP Git no Claude Code
$ claude mcp add --env 'GIT_ROOTS=<GIT_ROOTS>' git -- npx -y @abhishekmcp/gitInstalar o MCP Git no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"git": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/git"
],
"env": {
"GIT_ROOTS": "<GIT_ROOTS>"
}
}
}
}Instalar o MCP Git no VS Code
.vscode/mcp.json
{
"servers": {
"git": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@abhishekmcp/git"
],
"env": {
"GIT_ROOTS": "<GIT_ROOTS>"
}
}
}
}Instalar o MCP Git no VS Code CLI
$ code --add-mcp '{"name":"git","type":"stdio","command":"npx","args":["-y","@abhishekmcp/git"],"env":{"GIT_ROOTS":"<GIT_ROOTS>"}}'Instalar o MCP Git no Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"git": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/git"
],
"env": {
"GIT_ROOTS": "<GIT_ROOTS>"
}
}
}
}Instalar o MCP Git no Codex
$ codex mcp add git --env 'GIT_ROOTS=<GIT_ROOTS>' -- npx -y @abhishekmcp/gitInstalar o MCP Git no Codex config.toml
~/.codex/config.toml
[mcp_servers.git] command = "npx" args = ["-y", "@abhishekmcp/git"] [mcp_servers.git.env] GIT_ROOTS = "<GIT_ROOTS>"
Instalar o MCP Git no Gemini CLI
$ gemini mcp add -s user -e 'GIT_ROOTS=<GIT_ROOTS>' git npx -- -y @abhishekmcp/gitInstalar o MCP Git no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"git": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/git"
],
"env": {
"GIT_ROOTS": "<GIT_ROOTS>"
}
}
}
}Configuração
GIT_ROOTSObrigatórioAllowed 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
| Nome | Descrição | Tipo |
|---|---|---|
| GIT_ROOTS | Allowed repo root directories (comma-separated). Required — the server refuses to start without it. | Obrigatório |
| GIT_WRITABLE | Set to 1 or true to enable local write tools (stage/commit/branch/checkout). | |
| NOTES_DIR | — |
Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Passou em nossas verificações automatizadas. Isso não é uma auditoria de segurança: leia o código e dê ao servidor o acesso mais restrito de que ele precisa. Como as verificações funcionam
- Repositório de origem vinculado e acessívelabhishekkumar2021/mcp-suite is public and reachablegithub.com/abhishekkumar2021/mcp-suite ↗Passou
- O pacote indica este repositório como sua origem@abhishekmcp/git, @abhishekmcp/files name abhishekkumar2021/mcp-suite as sourcenpmjs.com/package/@abhishekmcp/git ↗Passou
- Proveniência da build (atestação Sigstore)Sigstore attestation for @abhishekmcp/git, @abhishekmcp/filesnpmjs.com/package/@abhishekmcp/git/v/0.2.0#provenance ↗Passou
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-07-04github.com/abhishekkumar2021/mcp-suite ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNo popular package one edit away from @abhishekmcp/git, @abhishekmcp/filesPassou
- Nenhum aviso crítico no pacote ou em suas dependências130 resolved dependencies checked; no critical advisoryosv.dev ↗Passou
- Sem instruções ocultas para o modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNão verificado
- O endpoint remoto responde ao handshake do MCPNão verificado
README
Ver no 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
Perguntas sobre o MCP Git
Como adiciono o MCP Git ao Claude Code?
Execute claude mcp add --env 'GIT_ROOTS=<GIT_ROOTS>' git -- npx -y @abhishekmcp/git no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP Git ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
Este servidor Git requer um binário Git local instalado?
Não, o servidor é escrito em JavaScript puro e não requer um binário Git para funcionar.
Quais operações de Git a IA pode realizar com este servidor?
O servidor suporta verificação de status, visualização de logs e diffs, inspeção de histórico de arquivos e branches/tags, realização de staging e commits controlados, além de gerenciamento de remotes via clone, fetch, pull e push.
Como posso instalar o servidor Git MCP?
Você pode instalá-lo via npm usando npx -y @abhishekmcp/git ou adicionando o plugin do Claude Code.