Filesystem MCP Server

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

Anthropic のリファレンス実装である modelcontextprotocol/servers を基にした、ファイルシステム操作用の Model Context Protocol（MCP）サーバーの Go 実装です。

リファレンス実装との主な違いは次のとおりです。

• get_file_info コマンドと directory_tree コマンドは、JSON データを返します。
• search_files ツールは、gitignore 形式の除外パターンに対応しています。

インストール

次のコマンドでサーバーをインストールします。

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

実行可能ファイルは通常 ~/go/bin にある 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：新しいファイルを作成するか、既存のファイルを新しい内容で完全に上書きします。

各ツールの詳細については、インスペクターを使用してください。

その他の実装

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

ライセンス

このリポジトリのコードは MIT ライセンスの下で配布されています。