MCP Server Prototype

🚀 文件系統 MCP 服務器

文件系統 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

📚 詳細文檔

• 資源
• 工具
• 提示
• Spring 集成
• Spring 最佳實踐
• 從 Dagger2 遷移到 Spring
• Dagger2 最佳實踐（供參考）

🔧 技術細節

資源

該服務器提供的資源如下：

• file://metadata/{path} - 獲取文件或目錄的元數據
• file://content/{path} - 獲取文件內容

有關更多詳細信息，請參閱資源文檔。

工具

該服務器提供的工具如下：

• list_files - 列出目錄中的文件

有關更多信息，請參閱工具文檔。

架構

服務器採用分層架構：

1. 配置層：用於依賴注入的 Spring 配置類
2. 服務層：核心服務，處理文件系統操作
3. 資源層：MCP 資源，用於暴露文件系統功能
4. 工具層：通用操作的輔助類

依賴注入

服務器使用 Spring 框架進行依賴注入，提供以下優勢：

• 使用構造函數注入以提高可測試性
• 使用 @PostConstruct 和 @PreDestroy 進行生命週期管理
• 使用配置類進行顯式 Bean 定義
• 自動發現組件掃描