Code Merge

🚀 コードマージ MCP サーバー

コードマージ MCP は、Model Context Protocol (MCP) に基づくサーバー実装で、コードファイルの内容抽出、マージ、分析のために設計されています。これは、大規模言語モデル（GPT、Claude など）がコードベースをより効果的に処理および分析するのを支援する強力なツールセットを提供します。

✨ 主な機能

• ファイルツリー生成：プロジェクトのファイル構造をツリービューで表示します。
• コードマージ：複数のファイル内容を単一の出力にマージします。
• コード分析：行数や関数の数などのコード統計情報を提供します。
• スマートフィルタリング：.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：関数の数をカウントするかどうか

出力：コード分析結果の統計情報を含みます。

📦 インストール

環境要件

• 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

🔍 プロジェクト構造

codemerge-mcp/
├── index.js          # MCP サーバーのメインプログラム
├── mcp-sdk/         # MCP SDK ディレクトリ（含まれています）
│   ├── config.json   # MCP 設定ファイル
│   └── lib/         # コアライブラリファイル
├── tools/           # ツールモジュールディレクトリ
│   ├── filetree.js  # ファイルツリー生成ツール
│   ├── merger.js    # コードマージツール
│   └── analyzer.js  # コード分析ツール
└── README.md        # プロジェクトドキュメント

🤝 コントリビューションガイド

• このプロジェクトをあなたの GitHub リポジトリに Fork します。
• tools/ ディレクトリに新しい機能モジュールを追加します。
• 変更をコミットしてプッシュします。
• コードレビューのために Pull Request を作成します。

📄 ライセンス

MIT License

🙏 謝辞

このプロジェクトは TownBoats/codeMerge をベースに開発されており、原作者の貢献に感謝いたします。