Skip to main content
Glama

Repomix MCP Server

A Model Context Protocol (MCP) server that provides access to the repomix tool for packing repositories into AI-friendly files.

Security

  • Input paths: The server restricts file access to the directory from which it was started. Any attempts to access files outside this directory (like /etc/) will be denied.

  • Output files: All output is written to the system's temporary directory and automatically cleaned up after the contents are returned.

  • Remote URLs: Remote repository URLs are still allowed for processing.

Installation

npm install npm run build

Usage

Claude Code

claude mcp add --scope user repomix node /path/to/repomix-mcp/dist/index.js

Claude Desktop

Add this server to your MCP client configuration in your claude_desktop_config.json:

{ "mcpServers": { "repomix": { "command": "node", "args": ["/path/to/repomix-mcp/dist/index.js"] } } }

Available Tools

Both tools accept the same parameters:

Parameters

Parameter

Type

Required

Description

Examples

path

string

No

Directory path to pack

/path/to/repo

style

enum

No

Output format style

xml, markdown, plain

compress

boolean

No

Compress output to reduce token count

true, false

include

string

No

Files to include (glob pattern)

*.md,*.ts,*.js, *.py, src/**/*.go

ignore

string

No

Files to exclude (glob pattern)

*test*,*spec*,dist/**,build/**

remote

string

No

Remote repository URL to process

https://github.com/user/repo

repomix-estimate

Estimate the size of repomix output without retrieving the content. Use this first to check if the output will fit in your context window.

Returns:

  • File size in KB/MB

  • Estimated token count (~4 characters per token)

  • Whether compression is enabled

repomix-estimate output

Repomix output size estimate: - Size: 5.27 KB (0.01 MB) - Estimated tokens: ~1,349 - Compression: disabled Use the repomix tool with these same parameters to retrieve the actual content.

repomix

Pack a repository into a single, AI-friendly file. Returns the contents of the generated file.

Best Practice: Always use repomix-estimate first to check the output size, then use repomix with appropriate parameters (especially compress=true for large repos).

Example usage in Claude:

  1. First check size: use repomix-estimate tool

  2. If size is reasonable: use repomix tool

  3. If too large, try with compression: use repomix-estimate tool with compress=true

  4. Then retrieve: use repomix tool with compress=true

Workflow: Always estimate first, then retrieve only if the size fits your needs.

repomix output (first 15 lines)

This file is a merged representation of a subset of the codebase, containing specifically included files, combined into a single document by Repomix. <file_summary> This section contains a summary of this file. <purpose> This file contains a packed representation of the entire repository's contents. It is designed to be easily consumable by AI systems for analysis, code review, or other automated processes. </purpose> <file_format> The content is organized as follows: 1. This summary section 2. Repository information
-
security - not tested
F
license - not found
-
quality - not tested

Latest Blog Posts

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/Aeolun/repomix-mcp'

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