What can you do with this server?

This server provides read-only Git access for AI-assisted code review and analysis (e.g., Kiro, Claude Code). It enforces strict security: only read operations, no arbitrary commands, shell execution, or credential helpers; repository paths are restricted and output sizes are capped. * Repository Management: List configured workspace repositories (git_list_repositories) and dynamically register worktrees under approved roots (git_register_repository). * Status & History: Check working tree status (git_status), browse filtered commit history (git_log), and inspect commit details with optional patches (git_show_commit). * Diffing & Comparison: Compare working tree, index, or any two revisions (git_diff), compare commit ranges (git_range_diff), and find merge base with ahead/behind counts (git_compare_refs). * File & Content Inspection: Blame files line-by-line (git_blame), search tracked content with regex (git_grep), browse file trees (git_list_tree), and read file content up to 1 MiB at any revision (git_read_file). * Refs & Remotes: List branches, tags, and remote-tracking refs (git_list_refs), view remote names without URLs (git_list_remotes), and fetch refs from public HTTPS remotes only (git_list_remote_refs).

Which integrations are available for this server?

Provides read-only access to Git repositories, enabling inspection of history, diffs, refs, file contents, and repository status.

How do I use git-readonly-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@git-readonly-mcp Show me the diff between develop and main" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

git-readonly-mcp

by kazuki0529

Overview Schema Related Servers Score Discussions

TypeScript

Local

Git Readonly MCP

Gitの履歴、差分、参照、ファイル内容をAIセルフレビューへ渡すためのread-only MCPサーバーです。Kiro、Claude Code、Claude Desktop、VS Codeから、同じローカルstdioサーバーを利用できます。

任意のGitコマンド実行機能は公開しません。起動時に許可したworkspace folder、またはrepository root配下に対し、用途別の型付きツールだけを提供します。

Requirements

Node.js 20以上
Git 2.43以上を推奨
信頼できるローカルGitリポジトリ

Related MCP server: CodeAudit MCP

Build

npm ci
npm run check
npm run test:integration

成果物は依存関係を含む単一ファイルです。

dist/git-readonly-mcp.mjs

GitHub Releaseを公開すると、release tagからbuildとtestを実行し、bundle、README、LICENSEを含むzipとSHA-256 checksumをRelease assetsへ添付します。

git-readonly-mcp-<tag>.zip
git-readonly-mcp-<tag>.zip.sha256

checksum fileとzipを同じディレクトリへ置き、次のコマンドで検証できます。

sha256sum --check git-readonly-mcp-<tag>.zip.sha256

直接起動する場合:

node /path/to/git-readonly-mcp/dist/git-readonly-mcp.mjs \
  --workspace-folder /path/to/frontend \
  --workspace-folder /path/to/backend \
  --repository-root /path/to/projects

--workspace-folderを省略した場合は、プロセスの現在ディレクトリだけを候補にします。指定したfolder自体がGit worktreeのルートでなければ利用不可として一覧へ表示し、親や子のリポジトリは自動探索しません。

--repository-rootは、AIがgit_register_repositoryで後から登録できる親ディレクトリです。指定した親そのものと配下だけを許可し、symlinkを解決した実体が範囲外なら拒否します。任意パスを無制限に許可するoptionはありません。

Placement

個人で複数プロジェクトから利用する場合は、bundleをユーザーディレクトリへ1つだけ置く構成を推奨します。

~/.mcp/git-readonly/git-readonly-mcp.mjs

MCP設定ではこのbundleを絶対パスで指定し、repositoryの許可範囲だけをclient側の--workspace-folderまたは--repository-rootで渡します。bundleの配置場所とGitへのアクセス許可は分離されています。プロジェクト内への配置は、teamで同じversionを固定し、設定もrepositoryで共有したい場合に適しています。

Client configuration

VS Code

単一root用の設定は .vscode/mcp.json に含まれています。multi-root workspaceでは、workspace folder名を明示します。

{
  "servers": {
    "git-readonly": {
      "type": "stdio",
      "command": "node",
      "args": [
        "/absolute/path/to/git-readonly-mcp.mjs",
        "--workspace-folder",
        "${workspaceFolder:Frontend}",
        "--workspace-folder",
        "${workspaceFolder:Backend}",
        "--repository-root",
        "${workspaceFolder}"
      ]
    }
  }
}

Kiro

このリポジトリを直接開く場合の設定は .kiro/settings/mcp.json に含まれています。別プロジェクトから利用する場合はbundleとrepositoryを絶対パスで指定します。提供する15ツールのうち、14個のGit参照ツールはread-onlyとしてautoApproveへ明示的に列挙しています。git_register_repositoryはserverが読める範囲を広げるため、自動承認から除外しています。

{
  "mcpServers": {
    "git-readonly": {
      "command": "node",
      "args": [
        "/absolute/path/to/git-readonly-mcp.mjs",
        "--repository-root",
        "/absolute/path/to/projects"
      ],
      "disabled": false,
      "autoApprove": [
        "git_list_repositories",
        "git_status",
        "git_log",
        "git_show_commit",
        "git_diff",
        "git_range_diff",
        "git_blame",
        "git_grep",
        "git_list_refs",
        "git_list_tree",
        "git_read_file",
        "git_compare_refs",
        "git_list_remotes",
        "git_list_remote_refs"
      ]
    }
  }
}

Claude Code

claude mcp add --transport stdio --scope project git-readonly -- \
  node /absolute/path/to/git-readonly-mcp.mjs \
  --workspace-folder /absolute/path/to/repository

またはproject rootの .mcp.json に設定します。

{
  "mcpServers": {
    "git-readonly": {
      "type": "stdio",
      "command": "node",
      "args": [
        "/absolute/path/to/git-readonly-mcp.mjs",
        "--workspace-folder",
        "/absolute/path/to/repository"
      ]
    }
  }
}

Claude Desktop

Developer settingsの claude_desktop_config.json に同じstdio起動設定を追加します。

{
  "mcpServers": {
    "git-readonly": {
      "type": "stdio",
      "command": "node",
      "args": [
        "/absolute/path/to/git-readonly-mcp.mjs",
        "--workspace-folder",
        "/absolute/path/to/repository"
      ]
    }
  }
}

Claude Desktop向けのワンクリック配布用 .mcpb は現在の成果物には含まれません。

Tools

Tool	Purpose
`git_list_repositories`	設定済みfolderと`repositoryId`を一覧化
`git_register_repository`	許可されたroot配下のworktreeを登録
`git_status`	branch、staged、unstaged、untracked状態を取得
`git_log`	revision、期間、author、message、pathで履歴を検索し、rename前も追跡
`git_show_commit`	commit metadata、stat、path限定可能なpatchを取得
`git_diff`	working tree、index、HEAD、2 revisionをcontext行数・rename検出指定で比較
`git_range_diff`	2つのcommit rangeを比較
`git_blame`	fileの行単位attributionを取得
`git_grep`	working tree、index、revisionの内容を検索
`git_list_refs`	branch、tag、remote-tracking refを一覧化
`git_list_tree`	revision時点のtreeを一覧化
`git_read_file`	revision、index、working treeからbounded fileを取得
`git_compare_refs`	merge baseとahead/behind件数を取得
`git_list_remotes`	URLを開示せずremote名を一覧化
`git_list_remote_refs`	設定済みpublic anonymous HTTPS remoteのrefを取得

最初にgit_list_repositoriesを呼びます。対象が未登録ならgit_register_repositoryへpathを渡し、返されたrepositoryIdを以後のツールへ渡します。ツール結果はstructuredContentとJSON textの両方で返されます。

AI review workflow

rename前を含む対象ファイルの履歴を取得します。followRenamesはpath指定時だけ利用できます。

{
  "repositoryId": "project-0123456789ab",
  "revision": "HEAD",
  "path": "docs/design.md",
  "followRenames": true,
  "limit": 20
}

履歴から選んだcommitを対象ファイルに限定して読みます。

{
  "repositoryId": "project-0123456789ab",
  "revision": "abc1234",
  "path": "docs/design.md",
  "includePatch": true,
  "contextLine": 8,
  "findRenames": true
}

HEADから現在のworking treeまでのtracked変更をまとめてレビューします。headはstagedとunstagedを含みますが、untracked fileは含みません。

{
  "repositoryId": "project-0123456789ab",
  "mode": "head",
  "path": "docs/design.md",
  "format": "patch",
  "contextLine": 8,
  "findRenames": true
}

git_diffの他のmodeは、workingがindex対working tree、stagedがHEAD対index、revisionsがbase対headです。mergeBase: trueを指定したrevisionsはmerge baseからheadまでを比較します。

作業中またはuntrackedの設計書全文はworking treeから読みます。

{
  "repositoryId": "project-0123456789ab",
  "target": "working",
  "path": "docs/design.md",
  "maxBytes": 262144
}

git_read_file.targetはrevision（既定）、index、workingから選択します。revisionだけがrevision入力を利用し、workingはsymlink解決後もrepository内にあるfileだけを読みます。

Security model

Gitはshellを介さず spawn します。
pager、external diff、textconv、credential helper、interactive prompt、optional lock、lazy fetchを抑止します。
revision rangeは個別parameterからサーバー側で構築します。
file pathはrepository-relative literalだけを許可します。
動的repository登録は、起動時の--repository-rootをcanonical pathで検証した配下だけに制限します。
local queryは既定15秒、blameとrange-diffは30秒、remote queryは10秒で停止します。
stdoutは1 MiB、stderrは64 KiBを上限とします。
remote問い合わせは設定済みremote名だけを受け取り、資格情報のないHTTPS URLかつpublic IPへ解決される場合だけ ls-remote を実行します。
SSH、HTTP、file URL、private/local address、fetch、pull、push、cloneは許可しません。

このサーバーはsandboxではありません。Git自体が読むrepository metadataを含め、信頼できるworkspaceだけを登録してください。

Development

npm run dev -- --workspace-folder /path/to/repository
npm run lint
npm run typecheck
npm test
npm run build
npm run test:integration
npm run pack:dry-run

MCP Inspectorで確認する場合:

npx @modelcontextprotocol/inspector node dist/git-readonly-mcp.mjs \
  --workspace-folder /path/to/repository

ログはstderrへ出力してください。stdio MCPのstdoutへ診断メッセージを出すとJSON-RPC通信が壊れます。

Install Server

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

1Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Tools

View all tools

Related MCP Servers

Sourceplane MCP
Version Control Code Analysis
infraWS
A
license
Not graded
quality
D
maintenance
Secure multi-source MCP server for reading local, GitHub, GitLab, Bitbucket, and network source code with read-only-by-default access, enabling AI assistants to inspect repositories safely.
Updated 19 days ago (2026-08-12 20:41 UTC)
1
MIT
CodeAudit MCP
Code Analysis Testing & QA Tools Developer Tools
priyanshuchawda
A
license
Not graded
quality
C
maintenance
A read-only MCP server for AI coding agents to inspect repositories, audit code quality, route engineering skills, and plan safe issue/PR workflows.
Updated 4 months ago (2026-05-04 04:27 UTC)
1
MIT
TimeVerse Code Reader
elimyliu
A
license
Not graded
quality
B
maintenance
A read-only MCP server for code reading with intelligent caching, line-range selection, and language detection, enabling AI assistants to efficiently and safely explore file systems.
Updated a month ago (2026-07-20 15:45 UTC)
MIT
weavatrix-git
Version Control Developer Tools
Weavatrix
A
license
Not graded
quality
A
maintenance
MCP server for fast, bounded, read-only Git evidence, enabling AI agents to query commit history, diffs, status, and snapshots by parsing repository storage directly.
Updated 6 days ago (2026-08-25 11:37 UTC)
345
MIT

View all related MCP servers

Related MCP Connectors

gread
An MCP server that gives your AI access to the source code and docs of all public github repos
neverinfamous-memory-journal-mcp
A MCP server built for developers enabling Git based project management with project and personal…
driflyte-mcp-server
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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/kazuki0529/git-readonly-mcp'

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

Git Readonly MCP

Requirements

Build

Placement

Client configuration

VS Code

Kiro

Claude Code

Claude Desktop

Tools

AI review workflow

Security model

Development

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

Sourceplane MCP

CodeAudit MCP

TimeVerse Code Reader

weavatrix-git

Related MCP Connectors

Latest Blog Posts

MCP directory API