MCP Server Filesystem

🚀 ファイルシステム MCP サーバ

このサーバは、Go言語で実装されたファイルシステム操作のモデルコンテキストプロトコル（MCP）サーバです。アイデアは Anthropic の参考実装に由来しており、詳細は modelcontextprotocol/servers を参照してください。

参考実装と比較した場合、このプロジェクトには以下の顕著な違いがあります。

• get_file_info と directory_tree コマンドは JSON データを返します。
• search_files ツールは、.gitignore のような除外パターンをサポートしています。

🚀 クイックスタート

このサーバは、Go言語で実装されたファイルシステム操作のモデルコンテキストプロトコル（MCP）サーバです。アイデアは Anthropic の参考実装に由来しています。

📦 インストール

以下のコマンドを使用してサーバをインストールします。

go install github.com/optistar/mcp-server-filesystem/cmd/mcp-server-filesystem@latest

実行可能ファイルは Go のバイナリディレクトリにインストールされ、通常は ~/go/bin です。このパスが PATH 環境変数に含まれていない場合は、設定を行ってください。

また、GOBIN 環境変数を設定することで、インストールディレクトリを変更することもできます。

📚 ドキュメント

テスト

完全なテストスイートが含まれており、サーバが期待通りに動作することを保証します。

• go test コマンドを使用して、通常通りテストを実行できます。
• tester コマンドは、テストスイートを MCP クライアントとしてパッケージ化し、MCP サーバコマンドや他の MCP サーバ実装のテストに使用できます。

ツール

このサーバは、ファイルシステムとの対話に以下のツールを提供します。

• create_directory：新しいディレクトリを作成するか、指定されたディレクトリが存在することを確認します。
• directory_tree：ファイルとディレクトリの再帰的なツリービューを取得し、JSON 構造で返します。
• edit_file：テキストファイルに対して行ベースの編集を行います。
• get_file_info：ファイルまたはディレクトリの詳細なメタデータを取得します。
• list_allowed_directories：このサーバがアクセスを許可するすべてのディレクトリのリストを返します。
• list_directory：指定されたパスの下にあるすべてのファイルとディレクトリの詳細なリストを取得します。
• move_file：ファイルやディレクトリを移動またはリネームします。
• read_file：ファイルシステムの完全な内容を読み取ります。
• read_multiple_files：複数のファイルの内容を同時に読み取ります。
• search_files：特定のパターンに一致するファイルとディレクトリを再帰的に検索します。
• write_file：新しいファイルを作成するか、既存のファイルを完全に上書きして新しい内容を書き込みます。

各ツールの詳細については、inspector を使用して確認してください。

その他の実装

このリポジトリは mark3labs/mcp-filesystem-server とは無関係です。

📄 ライセンス

このプロジェクトのコードは、MIT ライセンスに基づいて配布されています。