Skip to main content
Glama

repomcp

ci npm JSR JSR Score Runtime license

Universal repo-to-MCP bridge: introspect a repository, expose guarded MCP tools over stdio, generate multi-harness configs (Pi, OMP, Hermes, cc-switch, Claude Code, Kilo Code, Roo Code, Cursor, Cline, OpenCode), normalize embeddings for code indexers, and adapt tool-calling for Chinese providers and raw local checkpoints.

Install

Bun / npm:

bunx @kanchingyg/repomcp init --target all
npx @kanchingyg/repomcp init --target all

# or install in your project / globally
bun add -d @kanchingyg/repomcp
npm i -D @kanchingyg/repomcp

JSR:

bunx jsr add @kanchingyg/repomcp
npx jsr add @kanchingyg/repomcp

Related MCP server: github-assistant-mcp

Quick start

bunx @kanchingyg/repomcp init --target all
npx @kanchingyg/repomcp --mcp
npx @kanchingyg/repomcp embed --port 11435

Architecture

+--------+    +-------------+    +------------------+
|  repo  |--->| introspect  |--->| MCP tools (stdio)|
+--------+    +-------------+    +------------------+
     |                |                    |
     v                v                    v
+--------+    +-------------+    +------------------+
| harness|    | dirty-parser|    | embed normalizer |
| configs|    | checkpoints |    | (Kilo/Roo dims)  |
+--------+    +-------------+    +------------------+
     |                |                    |
     v                v                    v
 Pi OMP Hermes   Chinese providers    LanceDB/Qdrant
 Cursor Kilo     raw checkpoint EOS

Flags

Flag

Purpose

--mcp

Run stdio MCP server (stdout JSON-RPC guard enabled)

--allow-write

Enable mutating tools (read-only by default)

--dry-run

Simulate tool calls without side effects

Programmatic API

The package exports the runtime from repomcp, repomcp/bridge, and repomcp/runtime (also available on JSR as @kanchingyg/repomcp): MCP server, harness generators, provider/checkpoint helpers, dirty tool-call parser, and embedding normalizer.

MCP Tools Reference

Tool

Mutates

Description

repo_status

false

Inspect repository git status, tracked languages, and detected scripts.

run_script

true

Run a package.json, Cargo, or Makefile script inside the workspace (requires --allow-write).

search_code

false

Search repository source files with context-window budget truncation.

Editor and Agent Integration

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "repomcp": {
      "command": "npx",
      "args": ["-y", "@kanchingyg/repomcp", "--mcp"]
    }
  }
}

Claude Code CLI

claude mcp add repomcp -- npx -y @kanchingyg/repomcp --mcp

Programmatic Usage (JSR / TypeScript)

import * as bridge from "jsr:@kanchingyg/repomcp/bridge";

Runtime Safety and Guardrails

  • Stdio frame isolation: When --mcp is active, hijackStdoutForMcp() redirects accidental console.log calls to stderr so JSON-RPC 2.0 frames on stdout never corrupt.

  • Read-only by default: Mutating tools (mutates: true) are blocked in --dry-run mode and require explicit --allow-write authorization.

  • Loop breaker: Repeated identical (toolName, args) invocations are hashed with SHA-256 and halted after 3 consecutive repeats to prevent runaway agent loops.

  • Context budget truncation: Tool outputs are middle-truncated (60% head / 40% tail) scaled to the probed local model n_ctx (Ollama /api/show, llama.cpp /props, vLLM /v1/models).

  • Secret redaction and path normalization: AWS keys (AKIA*, ASIA*), bearer tokens, and sk-* keys are scrubbed before returning tool output, and Windows drive paths (C:\...) translate cleanly to /mnt/c/... when WSL mode is enabled.

License

MIT

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
      D
      maintenance
      Exposes Language Server Protocol (LSP) tools such as diagnostics, goto definition, find references, symbols, and rename as a stdio MCP server.
      8
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A read-only MCP server that lets AI assistants inspect local workspace files, search context, view git diffs, and fetch a fixed GitHub profile, all within a sandboxed stdio transport.
      5
      ISC
    • A
      license
      Not graded
      quality
      B
      maintenance
      Serves a repository's code knowledge graph over stdio (MCP) so coding agents can look up symbols, trace callers and callees, compute blast radius, list file symbols, run hybrid lexical-plus-graph search, and get citation-grounded answers from file:line evidence instead of guessing from text chunks. All tools work offline straight from the graph, with prose synthesis only when an OpenAI-compatible LLM endpoint is configured.
      17
      MIT