Skip to main content
Glama

mcp-git-readonly

npm version license: MIT CI

Read-only MCP server for one git repository with log, diff and blame tools, argument-injection-safe refs and paths, no external diff drivers and capped output

Problem

Describe in two or three sentences the concrete problem this utility solves, who hits it, and why existing packages do not solve it well. Keep it factual; link to an issue or decision record when there is one.

Related MCP server: Cross Repo Ops MCP

Install

npm install @trysac/mcp-git-readonly

Requires Node.js 20 or newer. The package ships ES modules with TypeScript declarations.

Usage

import { greet } from "@trysac/mcp-git-readonly";

// Build a greeting; surrounding whitespace is ignored.
const message = greet("  Ada ");
console.log(message); // "Hello, Ada!"

try {
  greet("   ");
} catch (error) {
  console.error((error as Error).message); // "name must not be empty"
}

API

Export

Signature

Description

greet

(name: string) => string

Placeholder API; replace it with the real one.

Development

npm install
npm run check   # lint, format, types, tests with coverage, docs, secrets

See AGENTS.md for the full command list and CONTRIBUTING.md for the workflow.

License

MIT © 2026 Miguel Gomez

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables read-only inspection of Git repository status and diff summaries, along with validation of OpenTofu and Ansible configurations, through a strictly limited, non-mutating toolset.
      MIT
    • F
      license
      B
      quality
      C
      maintenance
      Enables secure, policy-controlled operations on local git repositories through MCP, including bounded reads, context-checked patches, allowlisted tasks, and guarded git operations.
      10
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables MCP clients to inspect local Git repositories through five focused, read-only tools for repository trees, literal text search, numbered file reads, bounded git diffs, and project summaries while confining paths, skipping secret-like and binary files, and enforcing output limits.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides bounded, read-oriented access to authorized local workspaces through filesystem and git tools, multimodal file inspection, and explicitly allowlisted named tasks, without exposing write, delete, or arbitrary-shell capabilities.
      76 npm
      MIT