MCP Server Aibd Devcontainer

🚀 AI增強開發環境中的DevContainer

本項目提供了MCP服務器文件系統工具，可在Claude Desktop中使用，通過特定配置和命令行選項實現對文件系統的操作，並具備多種安全機制保障系統安全。

🚀 快速開始

要在Claude Desktop中使用MCP服務器，請將以下配置添加到claude_desktop_config.json：

{
  "mcpServers": {
    "aibd": {
      "command": "npx",
      "args": [
        "-y",
        "@gergelyszerovay/mcp-server-aibd-devcontainer",
        "--allowedDirectories=/your/allowed/path"
        // 如果需要啟用shell命令執行工具，請在此處添加"--enableShellExecTool"
      ]
    }
  }
}

📦 安裝指南

按照上述快速開始中的步驟，將配置添加到claude_desktop_config.json文件，即可完成MCP服務器在Claude Desktop中的安裝配置。

💻 使用示例

基礎用法

以下是一些使用MCP服務器的基礎命令示例：

# 啟用HTTP傳輸並指定允許訪問的目錄為當前目錄
$ mcp-fs --allowedDirectories=. --enableHttpTransport
# 指定允許訪問的目錄為/home/user/projects，並設置MCP HTTP服務器端口為3005，REST HTTP服務器端口為3006
$ mcp-fs --allowedDirectories=/home/user/projects --mcpHttpPort=3005 --restHttpPort=3006

高級用法

# 指定多個允許訪問的目錄
$ mcp-fs --allowedDirectories=/path/to/dir1 --allowedDirectories=/path/to/dir2
# 設置初始操作模式為mcpPlan
$ mcp-fs --allowedDirectories=. --initialMode=mcpPlan
# 啟用shell命令執行工具
$ mcp-fs --allowedDirectories=. --enableShellExecTool

📚 詳細文檔

命令行選項

以下是MCP服務器的可用選項：

MCP文件系統工具服務器。

選項：
  --enableHttpTransport         啟用HTTP傳輸 [默認: false]
  --enableStdioTransport        啟用stdio傳輸 [默認: true]
  --enableRestServer            啟用REST API服務器 [默認: false]
  --enableShellExecTool         啟用shell命令執行工具 [默認: false]
  --mcpHttpPort=<端口>          MCP HTTP服務器的端口 [默認: 3001]
  --restHttpPort=<端口>         REST HTTP服務器的端口 [默認: 3002]
  --allowedDirectories=<路徑>   允許訪問的目錄（多個，必需）
  --initialMode=<模式>          初始操作模式：mcpAct或mcpPlan [默認: mcpAct]
  --幫助                        顯示此幫助信息

示例：
  $ mcp-fs --allowedDirectories=. --enableHttpTransport
  $ mcp-fs --allowedDirectories=/home/user/projects --mcpHttpPort=3005 --restHttpPort=3006
  $ mcp-fs --allowedDirectories=/path/to/dir1 --allowedDirectories=/path/to/dir2
  $ mcp-fs --allowedDirectories=. --initialMode=mcpPlan
  $ mcp-fs --allowedDirectories=. --enableShellExecTool

🔧 技術細節

安全與部署

操作模式

服務器實現兩種操作模式：

• mcpPlan模式：只讀分析模式，允許模型分析環境但不進行任何更改。
• mcpAct模式：執行模式，授予對系統修改功能的完全訪問權限。 這種分離為意外的文件系統修改增加了一個安全屏障。

目錄限制

所有操作均限制在啟動時指定的明確允許目錄內。嘗試訪問這些目錄之外的文件將導致錯誤。

Shell命令執行安全性

shell命令執行工具默認禁用，必須通過--enableShellExecTool標誌顯式啟用。啟用後提供以下安全功能：

• 僅在“mcpAct”模式下可用，不在規劃模式下
• 可配置超時以防止長時間運行的過程
• 輸出大小限制以防信息過載
• 完整命令結果報告，包括退出代碼
• 分開的stdout和stderr流以便更好地診斷
• 命令失敗的手動處理

⚠️ 重要提示

啟用shell命令執行將授予模型在系統上執行任意命令的能力。始終仔細審查AI生成的命令後再允許其執行。