Universal Project MCP Server

ユニバーサルプロジェクト MCP サーバー

Claude がコンテキストの制限を受けずにプロジェクト全体へ接続できる、シンプルな MCP サーバーです。Claude はコードベース全体の構造を調べ、必要なファイルを読み取れますが、変更は加えません。

このツールを作った理由

主な目的は、コンテキストの制限に達することなく、Claude がプロジェクト構造を理解するための完全なアクセスを提供することです。つまり、Claude をできるだけ効率よく使えます。コードの抜粋をコピーして貼り付ける代わりに、Claude は次のことができます。

• プロジェクト全体の構造を一度に確認する
• コードを理解するために必要なファイルを読み取る
• 複数のファイルを検索して、探しているものを見つける
• 特定のキーワードを含むファイルを検索する
• プロジェクトがどのように構成されているかを全体的に把握する
• プロジェクトの種類、依存関係、重要なファイルをすぐに分析する

ファイル編集機能はどうなったのですか？

当初、ファイルの作成、編集、削除を行う CRUD 操作とコマンド実行機能を追加しようとしましたが、あまり効果的ではありませんでした。Claude が予期しない変更を加えたり、意図していないコマンドを実行したりすることがありました。そのため、ファイルの変更機能とコマンド実行機能はすべて削除しました。

現在は読み取り専用です。これにより、Claude はすべてを理解できますが、実際に変更を加えるかどうかは自分で管理できます。

利用可能なメソッド

プロジェクトの設定

• set_project_path(path) - プロジェクトディレクトリを指定します
• get_project_path() - 現在のプロジェクトパスを確認します

プロジェクトのスマート分析

• get_project_summary() - プロジェクトの全体像（種類、README ファイル、統計、複雑さ）を取得します
• get_dependencies() - 設定ファイルからプロジェクトの依存関係をすべて分析します
• find_entry_points() - メインファイル、設定ファイル、ルート、その他の重要なファイルを見つけます

プロジェクトの探索

• get_structure(path, max_depth) - ディレクトリツリー全体を取得します
• list_directory(path) - 指定したフォルダー内のファイルを一覧表示します
• read_file(file_path, start_line, end_line) - 任意のファイルを読み取ります（行範囲の指定は任意です）
• get_file_info(file_path) - ファイルの詳細と統計情報を取得します

ファイルの検索

• search_files(pattern, path, include_content, file_extensions, max_results) - ファイル名または内容からファイルを検索します

使い方

1. プロジェクトを一度設定する：プロジェクトの場所を Claude に伝えます
2. Claude にすぐ分析させる：新しいスマートメソッドを使って、Claude がプロジェクトをすぐに理解できるようにします
3. 的を絞ったサポートを受ける：Claude が適切なファイルに注目し、技術スタックを理解します
4. 変更を実装する：全体のコンテキストに基づいて、Claude が的確な提案を行います

インストール

cd coding-mcp-server
uv sync

Claude の設定

Claude デスクトップアプリの設定に次の内容を追加します。

{
  "mcpServers": {
    "universal-project": {
      "command": "uv",
      "args": ["run", "python", "D:\\path\\to\\your\\coding-mcp-server\\server_mcp.py"],
      "cwd": "D:\\path\\to\\your\\coding-mcp-server"
    }
  }
}

使用例 - 導入前と導入後

You: "Set my project to D:\MyFlutterApp"
Claude: *calls get_project_summary()*
"✓ This is a Flutter project with 156 files, medium complexity. 
Found README.md at root. Main directories: lib/, android/, ios/"

Claude: *calls get_dependencies()*  
"Uses 23 dependencies including http, provider, flutter_bloc"

Claude: *calls find_entry_points()*
"Main entry: lib/main.dart, Config: pubspec.yaml"

Claude: *reads README.md*
"I can see this is an e-commerce app with user authentication..."

Result: Claude understands your entire project in seconds!

主なメリット

• コンテキストの制限なし：Claude はトークン数の制限を受けずにプロジェクト全体を確認できます
• すぐに分析：新しいメソッドにより、プロジェクトをすぐに理解できます
• 重要なファイルに注目：Claude はどのファイルを読むべきか把握できます
• 技術スタックを把握：依存関係とプロジェクトの種類を理解します
• ドキュメントを把握：README やドキュメントを自動的に見つけて読み取ります
• 安全な読み取り専用：誤ったファイル変更やコマンド実行がありません

---