Model Context Protocol (mcp) Server Filesystem Implementation

🚀 模型上下文協議（MCP）服務器 - 文件系統實現

本項目是一個使用Go語言和Echo框架實現的教育性質的模型上下文協議（MCP）服務器，它藉助MCP協議為開發者提供對本地文件系統的訪問能力。

🚀 快速開始

先決條件

• Go 1.24或更高版本

安裝

1. 克隆倉庫。
2. 安裝依賴項：go mod tidy。
3. 運行服務器：go run main.go。

服務器默認將在8080端口啟動，您可以通過設置PORT環境變量來更改端口。

✨ 主要特性

• 文件系統提供者：通過MCP工具和資源提供對本地文件系統的訪問。
• 工具：
  • filesystem.list：列出目錄內容。
  • filesystem.read：讀取文件內容。
  • filesystem.write：向文件寫入內容。
  • filesystem.delete：刪除文件或目錄。
• 資源：
  • filesystem.file：表示文件系統中的一個文件。
  • filesystem.directory：表示文件系統中的一個目錄。

📚 詳細文檔

概述

模型上下文協議（MCP）是一個開放標準，它能讓開發者構建安全的雙向連接，用於數據源與AI工具之間的通信。本實現展示瞭如何創建一個提供本地文件系統訪問權限的MCP服務器。

API 端點

• GET /：獲取服務器信息。
• POST /v1/discover：發現服務器功能。
• POST /v1/call-tool：調用工具。
• POST /v1/load-resource：加載資源。

💻 使用示例

基礎用法

發現服務器功能

curl -X POST http://localhost:8080/v1/discover

列出目錄內容

curl -X POST http://localhost:8080/v1/call-tool \
  -H "Content-Type: application/json" \
  -d '{
    "tool_id": "filesystem.list",
    "request_id": "req-123",
    "params": {
      "arguments": {
        "path": "."
      }
    }
  }'

讀取文件內容

curl -X POST http://localhost:8080/v1/call-tool \
  -H "Content-Type: application/json" \
  -d '{
    "tool_id": "filesystem.read",
    "request_id": "req-123",
    "params": {
      "arguments": {
        "path": "your_file_path"
      }
    }
  }'

🔧 技術細節

此實現包含基本的路徑清理功能，以防止目錄遍歷攻擊，但僅用於教育目的。在生產環境中，需要額外的安全措施，例如：

• 用戶身份驗證和授權
• 更強大的輸入驗證
• 速率限制
• 審計日誌記錄
• 隔離沙盒