Code Merge

🚀 代碼合併 MCP 服務器

代碼合併 MCP 是一款基於 Model Context Protocol (MCP) 的服務器實現，專為代碼文件內容的提取、合併與分析而精心打造。它提供了一套強大的工具，能助力大語言模型（如GPT、Claude）更高效地處理和分析代碼庫。

🚀 快速開始

代碼合併 MCP 服務器旨在幫助大語言模型更好地處理和分析代碼庫。你可以按照以下步驟進行安裝和使用：

環境要求

• Node.js (v16.x 或更高版本)
• MCP SDK

安裝步驟

1. 克隆項目倉庫：

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

2. 安裝依賴項：

npm install

3. 啟動服務器：

node index.js

✨ 主要特性

• 文件樹生成：生成項目文件結構的樹狀視圖
• 代碼合併：將多個文件的內容合併為單一輸出
• 代碼分析：提供代碼統計信息，如行數和函數數量
• 智能過濾：支持 .gitignore 規則和自定義黑名單

🔧 技術細節

本項目基於 Model Context Protocol (MCP) SDK 構建，使用 Node.js 實現。主要組件包括：

• MCP 服務器：處理客戶端請求並提供工具功能
• 工具模塊：實現各種代碼處理功能
• 核心庫：提供文件系統操作和過濾功能

📚 詳細文檔

工具說明

1. get_file_tree

生成項目文件結構的樹狀視圖，支持多種過濾選項。

參數：

• path：目標目錄路徑
• use_gitignore：是否使用 .gitignore 規則（可選）
• ignore_git：是否忽略 .git 目錄（可選）
• custom_blacklist：自定義黑名單項目（可選）

示例輸出：

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

2. merge_content

將多個文件的內容合併為單一輸出，適合準備用於大語言模型的代碼分析。

參數：

• path：目標文件或目錄路徑
• compress：是否壓縮輸出（可選）
• use_gitignore：是否使用 .gitignore 規則（可選）
• ignore_git：是否忽略 .git 目錄（可選）
• custom_blacklist：自定義黑名單項目（可選）

輸出：包含合併後的文件內容和統計信息

3. analyze_code

分析代碼文件並提供統計信息，如行數和函數數量。

參數：

• path：目標文件或目錄路徑
• language：可選的語言過濾器
• countLines：是否統計代碼行數
• countFunctions：是否統計函數數量

輸出：包含代碼分析結果的統計信息

項目結構

codemerge-mcp/
├── index.js          # MCP 服務器主程序
├── mcp-sdk/         # MCP SDK 目錄（已包含）
│   ├── config.json   # MCP 配置文件
│   └── lib/         # 核心庫文件
├── tools/           # 工具模塊目錄
│   ├── filetree.js  # 文件樹生成工具
│   ├── merger.js    # 代碼合併工具
│   └── analyzer.js  # 代碼分析工具
└── README.md        # 項目文檔

貢獻指南

• Fork 該項目到你的 GitHub 倉庫。
• 在 tools/ 目錄下添加新的功能模塊。
• 提交併推送你的更改。
• 創建 Pull Request 進行代碼審查。

📄 許可證

MIT License

致謝

本項目基於 TownBoats/codeMerge 開發，感謝原作者的貢獻。