Filesystem MCP Server

Filesystem MCP Server

ファイルのメタデータとコンテンツにアクセスするためのリソースを提供する MCP サーバーです。

概要

Filesystem MCP Server は、ファイルのメタデータとコンテンツにアクセスするためのリソースを提供する Model Context Protocol（MCP）サーバーです。クライアントは、ファイルやディレクトリに関する情報を取得したり、ファイルのコンテンツを読み取ったりできます。

機能

• ファイルやディレクトリのメタデータ（名前、パス、サイズ、タイムスタンプ、アクセス許可など）を取得
• テキストファイルとバイナリファイルのコンテンツを読み取り
• ファイル拡張子に基づいて MIME タイプを自動検出
• 包括的なログ記録
• 保守性とテスト容易性を高めるため、Spring Framework を使用して依存関係を注入

リソース

サーバーは次のリソースを提供します。

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

詳しくは、リソースのドキュメントをご覧ください。

ツール

サーバーは次のツールを提供します。

• list_files - ディレクトリ内のファイルを一覧表示

詳しくは、ツールのドキュメントをご覧ください。

ビルドと実行

前提条件

• Java 17 以上
• Maven
• Spring Framework（Maven によって自動的に管理されます）

ビルド

mvn clean package

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

実行

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

ドキュメント

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

アーキテクチャ

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

1. 設定レイヤー：依存関係の注入を行う Spring 設定クラス
2. サービスレイヤー：ファイルシステム操作の中核となるサービス
3. リソースレイヤー：ファイルシステムの機能を公開する MCP リソース
4. ユーティリティレイヤー：一般的な操作を行うユーティリティクラス

依存関係の注入

サーバーは依存関係の注入に Spring Framework を使用しており、次の機能を利用できます。

• テスト容易性を高めるコンストラクターインジェクション
• @PostConstruct と @PreDestroy によるライフサイクル管理
• 明示的な Bean 定義を行う設定クラス
• Bean を自動検出するコンポーネントスキャン

ライセンス

このプロジェクトは MIT ライセンスのもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。