What is repo-context-mcp?

repo-context-mcp is a local Model Context Protocol server and CLI for repository maps, code search, and token-aware context packs. It helps Codex, Claude Code, Cursor, Cline, and other MCP-compatible clients understand a codebase without dumping the whole repository into the prompt.

How do I install repo-context-mcp?

Use npx -y repo-context-mcp in an MCP client config, or clone the GitHub repository and build it from source with Node.js 18 or newer.

Which MCP transport does it use?

The reviewed README describes stdio transport for local MCP clients.

repo-context-mcp

Name: repo-context-mcp
Author: Nguyen Duc

by Nguyen Duc

communitystdionpmVerified

View all implementations

104stars|91forks

View on GitHub Docs

Works withClaude DesktopCursorVS CodeWindsurf

About

Local MCP server for repo maps, code search, and token-aware context packs.

Features

Generate lightweight repository maps with entrypoints and manifests
Search source-like files and return path:line hits
Pack focused code context into token-budgeted Markdown
Respects .gitignore and skips common vendor or build directories
Works as both an MCP server and a CLI for scripts

Use Cases

AI coding agent users

Give Claude Code, Codex, Cursor, or Cline focused repository context without pasting a whole monorepo.

Engineering teams reviewing code

Create repeatable context packs for pull requests, architecture review, and bug investigation.

What This Server Can Do

MCP servers expose three types of capabilities to AI clients. Here's what repo-context-mcp supports.

Tools

Supported3 tools

Functions your AI client can call to perform actions — like querying a database, creating a file, or calling an API.

How to use: Tools run automatically when your AI client decides they're needed. Ask your AI assistant to perform a task, and it will invoke the right tool.

Resources

Not available

This server does not expose read-only data resources.

Prompts

Not available

This server does not provide pre-built prompt templates.

For the full list of available tools, resources, and prompts, check the README on GitHub.

Available Tools (3)

repo_map

Generate a lightweight repository tree and likely entrypoints.

search_code

Search source-like files and return path:line matches.

pack_context

Build a focused token-budgeted Markdown context pack.