JinDaGe - mcp-server-aibd-devcontainer MCP Details

article

README

🚀 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生成的命令后再允许其执行。

mcp-server-aibd-devcontainer