repomix-mcp

An MCP server that provides intelligent context gathering capabilities using repomix. This tool helps AI assistants understand your codebase better by automatically analyzing project structure and gathering relevant context.

Features

• Smart directory detection and context gathering
• Project type detection (React, Vue, Angular)
• Configurable file patterns and exclusions
• Automatic configuration file inclusion
• Project structure analysis for optimal context gathering
• Concise summaries for users with full context for AI

Installation

You can use repomix-mcp directly with npx without installing:

1npx repomix-mcp

Or install globally:

1npm install -g repomix-mcp

Usage

As an MCP Server

Add to your MCP settings configuration file (e.g., claude_desktop_config.json):

1{
2  "mcpServers": {
3    "repomix": {
4      "command": "npx",
5      "args": ["repomix-mcp"],
6      "env": {},
7      "disabled": false,
8      "autoApprove": []
9    }
10  }
11}

Or if installed globally:

1{
2  "mcpServers": {
3    "repomix": {
4      "command": "repomix-mcp",
5      "args": [],
6      "env": {},
7      "disabled": false,
8      "autoApprove": []
9    }
10  }
11}

Available Tools

1. gather_context

Gathers context from specified directories using repomix.

Parameters:

• baseDir (required): Base directory to search in
• targetDirs (optional): Target directories to find (e.g. ['translations', 'src'])
• patterns (optional): File patterns to include
• depth (optional): Context gathering depth ('shallow', 'dependencies', 'full')
• includeConfigs (optional): Include configuration files
• excludePatterns (optional): Patterns to exclude

Example:

1await mcp.use("repomix", "gather_context", {
2  baseDir: "/path/to/project",
3  targetDirs: ["src", "translations"],
4  patterns: ["*.ts", "*.tsx"],
5  includeConfigs: true,
6  excludePatterns: ["**/*.test.*"],
7});

Output:

📦 Context Summary:

Total Files: 2
Total Lines: 150
Total Characters: 4500

Files Included:
- src/index.ts (100 lines, 3000 chars)
- translations/en.ts (50 lines, 1500 chars)

2. analyze_project

Analyzes project structure and suggests context gathering strategy.

Parameters:

• projectDir (required): Project directory to analyze

Example:

1await mcp.use("repomix", "analyze_project", {
2  projectDir: "/path/to/project",
3});

Output:

1{
2  "projectType": "react",
3  "suggestedConfig": {
4    "baseDir": "/path/to/project",
5    "targetDirs": ["src", "components", "pages", "hooks"],
6    "patterns": ["*.tsx", "*.jsx"],
7    "includeConfigs": true,
8    "depth": "dependencies",
9    "excludePatterns": ["**/*.test.*", "**/*.spec.*", "**/node_modules/**"]
10  }
11}

Development

1. Clone the repository:

1git clone https://github.com/yourusername/repomix-mcp.git
2cd repomix-mcp

2. Install dependencies:

1npm install

3. Build the project:

1npm run build

4. Run locally:

1npm start

License

MIT