Code Merge

🚀 Code Merge MCP Server

Code Merge MCP is a server implementation based on the Model Context Protocol (MCP), designed for code file content extraction, merging, and analysis. It offers a powerful set of tools to help large language models (such as GPT and Claude) process and analyze codebases more effectively.

🚀 Quick Start

Code Merge MCP is a server implementation based on Model Context Protocol (MCP), designed for code file content extraction, merging, and analysis. It provides a set of powerful tools to help large language models (e.g., GPT, Claude) process and analyze codebases more effectively.

✨ Features

• File Tree Generation: Generate a tree view of the project file structure.
• Code Merging: Merge the contents of multiple files into a single output.
• Code Analysis: Provide code statistics, such as the number of lines and functions.
• Intelligent Filtering: Support .gitignore rules and custom blacklists.

🔧 Technical Details

This project is built on the Model Context Protocol (MCP) SDK and implemented using Node.js. The main components include:

• MCP Server: Handle client requests and provide tool functions.
• Tool Modules: Implement various code processing functions.
• Core Library: Provide file system operations and filtering functions.

📚 Documentation

1. get_file_tree

Generate a tree view of the project file structure, supporting various filtering options.

Parameters:

• path: Path to the target directory.
• use_gitignore: Whether to use .gitignore rules (optional).
• ignore_git: Whether to ignore the .git directory (optional).
• custom_blacklist: Custom blacklist items (optional).

Sample Output:

project/
├── src/
│   ├── main.js
│   └── utils/
│       └── helper.js
├── tests/
│   └── test.js
└── README.md

2. merge_content

Merge the contents of multiple files into a single output, suitable for preparing code analysis for large language models.

Parameters:

• path: Path to the target file or directory.
• compress: Whether to compress the output (optional).
• use_gitignore: Whether to use .gitignore rules (optional).
• ignore_git: Whether to ignore the .git directory (optional).
• custom_blacklist: Custom blacklist items (optional).

Output: Contains the merged file content and statistical information.

3. analyze_code

Analyze code files and provide statistical information, such as the number of lines and functions.

Parameters:

• path: Path to the target file or directory.
• language: Optional language filter.
• countLines: Whether to count the number of code lines.
• countFunctions: Whether to count the number of functions.

Output: Contains statistical information on the code analysis results.

📦 Installation

Environment Requirements

• Node.js (v16.x or higher)
• MCP SDK

Installation Steps

1. Clone the project repository:

git clone https://github.com/yourusername/codemerge-mcp.git
cd codemerge-mcp

2. Install dependencies:

npm install

3. Start the server:

node index.js

📚 Documentation

Project Structure

codemerge-mcp/
├── index.js          # Main program of the MCP server
├── mcp-sdk/         # MCP SDK directory (included)
│   ├── config.json   # MCP configuration file
│   └── lib/         # Core library files
├── tools/           # Tool module directory
│   ├── filetree.js  # File tree generation tool
│   ├── merger.js    # Code merging tool
│   └── analyzer.js  # Code analysis tool
└── README.md        # Project documentation

Contribution Guidelines

• Fork the project to your GitHub repository.
• Add new functional modules in the tools/ directory.
• Commit and push your changes.
• Create a Pull Request for code review.

📄 License

MIT License

Acknowledgments

This project is developed based on TownBoats/codeMerge. Thanks to the original author for their contribution.