mcp-server-repomix

mlopezgez/mcp-server-repomix

3.2

If you are the rightful owner of mcp-server-repomix and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Repomix MCP Server for Zed is an extension that integrates Repomix as a Model Context Protocol server, allowing AI assistants to efficiently pack and analyze entire codebases.

Tools
3
Resources
0
Prompts
0

Repomix MCP Server for Zed

A Zed extension that integrates Repomix as a Model Context Protocol (MCP) server, enabling AI assistants to pack and analyze entire codebases.

Features

  • Repository Packing: Pack local or remote repositories into a single AI-friendly file
  • MCP Integration: Seamlessly integrates with Zed's Assistant through the Model Context Protocol
  • Flexible Configuration: Support for custom Repomix paths and settings
  • AI-Optimized Output: Generates comprehensive codebase context for AI analysis

What is Repomix?

Repomix is a powerful tool that packs your entire repository into a single file optimized for AI consumption. It's particularly useful for:

  • Providing comprehensive codebase context to AI assistants
  • Analyzing repository structure and dependencies
  • Creating shareable codebase snapshots for AI analysis
  • Supporting multiple output formats (XML, Markdown, Plain text)

Prerequisites

Before using this extension, you need to have:

  1. Zed Editor: Version with MCP support
  2. Node.js: Required for running Repomix
  3. Repomix: Install globally with: 
    npm install -g repomix

Installation

From Zed Extension Marketplace

  1. Open Zed
  2. Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Linux/Windows)
  3. Type "zed: extensions" and select it
  4. Search for "Repomix MCP Server"
  5. Click "Install"

From Source

  1. Clone this repository:

    git clone https://github.com/mlopezgez/zed-mcp-server-repomix.git
cd zed-mcp-server-repomix

  2. Build the extension:

    cargo build --release

  3. Install in Zed:

    # Copy to Zed extensions directory
mkdir -p ~/.config/zed/extensions
cp -r . ~/.config/zed/extensions/mcp-server-repomix

Configuration

Basic Setup

Add the following to your Zed settings (~/.config/zed/settings.json):

{
  "context_servers": {
    "mcp-server-repomix": {}
  }
}

Custom Repomix Path (Optional)

If you have Repomix installed in a custom location:

{
  "context_servers": {
    "mcp-server-repomix": {
      "settings": {
        "repomix_path": "/custom/path/to/repomix"
      }
    }
  }
}

Remote Repositories

Repomix can pack remote repositories by providing a repository URL. Simply pass the repository URL using either HTTPS (e.g., https://github.com/user/repo) or SSH (e.g., git@github.com:user/repo.git) to the pack repository tool.

Usage

Once installed and configured, the Repomix MCP server will be available in your Zed Assistant. The assistant can use Repomix tools to:

  1. Pack repositories: Convert entire codebases into AI-friendly format
  2. Analyze code structure: Understand repository organization and dependencies
  3. Search packed output: Find specific patterns and code elements
  4. Read packed content: Extract specific files or sections from packed repositories

Example Prompts

Try these prompts with your Zed Assistant:

  • "Pack the current repository and show me an overview"
  • "Analyze the structure of repository https://github.com/yamadashy/repomix"
  • "Pack only the TypeScript files in the src directory"
  • "Find all authentication-related code in this repository"

Available MCP Tools

The extension provides the following MCP tools to the Zed Assistant:

  • pack_repository: Pack a local or remote repository
  • read_packed_output: Read and analyze packed repository output
  • search_packed_output: Search for specific patterns in packed output

Development

Building from Source

# Install Rust if you haven't already
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Clone and build
git clone https://github.com/mlopezgez/zed-mcp-server-repomix.git
cd zed-mcp-server-repomix
cargo build --release

Project Structure

zed-mcp-server-repomix/
├── src/
│   └── mcp_server_repomix.rs    # Main extension implementation
├── configuration/
│   ├── installation_instructions.md
│   └── default_settings.jsonc
├── Cargo.toml                    # Rust dependencies
├── extension.toml                # Zed extension metadata
└── README.md

Troubleshooting

Server Not Starting

If the MCP server fails to start:

  1. Verify Repomix is installed: repomix --version
  2. Check Node.js is installed: node --version
  3. Ensure the extension is enabled in Zed settings
  4. Restart Zed after configuration changes

Permission Issues

If you encounter permission errors:

  1. Ensure you have write permissions in the project directory
  2. Verify Repomix can execute: which repomix
  3. Check Node.js permissions

Debug Mode

Enable debug logging in Zed to see detailed MCP server output:

{
  "assistant": {
    "debug": true
  }
}

Related Projects

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the file for details.

Acknowledgments

Links