MCP Server Prototype

🚀 文件システム MCP サーバ

このサーバは、ファイルのメタデータと内容にアクセスするためのリソースを提供する MCP サーバです。

🚀 クイックスタート

ファイルシステム MCP サーバは、モデルコンテキストプロトコル（MCP）サーバで、ファイルのメタデータと内容にアクセスするためのリソースを提供します。クライアントは、このサーバを通じて、ファイルやディレクトリに関する情報を取得し、ファイルの内容を読み取ることができます。

✨ 主な機能

• ファイルやディレクトリのメタデータ（名前、パス、サイズ、タイムスタンプ、権限など）を取得する
• テキストファイルやバイナリファイルの内容を読み取る
• ファイル拡張子に基づく自動 MIME タイプ検出
• 全面的なログ記録
• Spring フレームワークを使用した依存性注入により、保守性とテスト性を向上させる

📦 インストール

前提条件

• Java 17 以上
• Maven
• Spring フレームワーク（Maven によって自動管理）

ビルド

mvn clean package

これにより、target ディレクトリに実行可能な JAR ファイルが作成されます。

実行

java -jar target/filesystem-mcp-1.0-SNAPSHOT-jar-with-dependencies.jar

💻 使用例

基本的な使用法

このサーバが提供するリソースは以下の通りです：

• file://metadata/{path} - ファイルまたはディレクトリのメタデータを取得
• file://content/{path} - ファイルの内容を取得

詳細については、リソースドキュメントを参照してください。

高度な使用法

このサーバが提供するツールは以下の通りです：

• list_files - ディレクトリ内のファイルをリストする

詳細については、ツールドキュメントを参照してください。

📚 ドキュメント

• リソース
• ツール
• ヒント
• Spring 統合
• Spring ベストプラクティス
• Dagger2 から Spring への移行
• Dagger2 ベストプラクティス（参考用）

🔧 技術詳細

アーキテクチャ

サーバは階層化アーキテクチャを採用しています：

1. 設定層：依存性注入用の Spring 設定クラス
2. サービス層：ファイルシステム操作を処理する核心サービス
3. リソース層：ファイルシステム機能を公開する MCP リソース
4. ツール層：一般的な操作の補助クラス

依存性注入

サーバは Spring フレームワークを使用して依存性注入を行い、以下の利点を提供します：

• コンストラクタ注入を使用してテスト性を向上させる
• @PostConstruct と @PreDestroy を使用してライフサイクル管理を行う
• 設定クラスを使用して明示的な Bean 定義を行う
• コンポーネントスキャンによる自動検出