MCP Server Filesystem

🚀 文件系統 MCP 服務器

這是一個基於 Go 語言實現的文件系統操作模型上下文協議（MCP）服務器，它受到 Anthropic 參考實現的啟發。您可以點擊此處查看參考實現。該服務器能夠高效處理文件系統操作，為用戶提供便捷的文件管理體驗。

🚀 快速開始

本服務器基於 Go 語言實現，可幫助您輕鬆進行文件系統操作。與參考實現相比，本項目有一些顯著差異，如 get_file_info 和 directory_tree 命令返回 JSON 數據，search_files 工具支持類似於 .gitignore 的排除模式。

📦 安裝指南

使用以下命令安裝服務器：

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

可執行文件將安裝到 Go 二進制目錄中，通常為 ~/go/bin。如果該路徑不在您的 PATH 環境變量中，請進行相應配置。您還可以通過設置 GOBIN 環境變量來更改安裝目錄。

✨ 主要特性

• JSON 數據返回：get_file_info 和 directory_tree 命令返回 JSON 數據，方便數據處理和解析。
• 靈活的搜索工具：search_files 工具支持類似於 .gitignore 的排除模式，讓文件搜索更加精準。
• 完整測試套件：包含完整的測試套件，確保服務器按預期運行。

💻 使用示例

測試服務器

• 可以使用 go test 命令正常運行測試。

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 許可證分發。