MCP 服务器

Mcp Server Aibd Devcontainer

用于 VS Code DevContainers 中 AI 增强开发的 MCP 服务器。

gergelyszerovay

开发者工具

访问服务器

README

DevContainers 中 AI 增强开发

MCP 服务器旨在增强 DevContainer 环境中 AI 辅助的开发。它提供文件系统操作和工具，以促进 AI 助手和容器化开发环境之间的无缝协作。文件系统操作基于 Anthropic 的 Filesystem MCP 服务器。

安装

为了最简单地开始在 devcontainer 中进行 AI 辅助开发，请按照 AIBD Devcontainer 仓库中的安装步骤进行操作。该仓库提供了一个预配置的开发容器设置，其中已集成了 MCP 服务器。

步骤包括：

克隆 aibd-devcontainer 仓库
在 VS Code 中打开并使用“Reopen in Container”功能
配置 Claude 以连接到 MCP 服务器
开始使用 AI 辅助进行开发

预配置的设置处理了设置 MCP 服务器、端口转发和文件访问权限的所有细节。

功能

完整的文件系统操作（读取、写入、编辑等）
目录树
文件搜索和元数据检索
用于安全性的 Plan 和 Act 操作模式
用于安全性的允许目录限制
SSE（服务器发送事件）传输支持，非常适合 dockerized 环境
REST API
可选的 shell 命令执行功能（默认禁用）

API

工具

文件读取

read_multiple_files
- 同时读取多个文件
- 输入：
  - paths (string[]): 要读取的文件的路径
- 返回：
  - 包含其路径的文件内容数组

文件写入/修改

write_file
- 创建一个新文件或完全覆盖现有文件
- 输入：
  - path (string): 要写入的文件的路径
  - content (string): 要写入文件的内容
- 返回：
  - 确认消息
- 注意: 仅在 "mcpAct" 模式下可用
edit_file
- 对文本文件进行基于行的编辑
- 输入：
  - path (string): 要编辑的文件的路径
  - edits (array): 编辑操作数组
  - dryRun (boolean): 预览更改而不写入
- 返回：
  - 显示更改的 Git 风格的差异
- 注意: 仅在 "mcpAct" 模式下可用

目录操作

create_directory
- 创建一个新目录或确保目录存在
- 输入：
  - path (string): 要创建的路径
- 返回：
  - 确认消息
- 注意: 仅在 "mcpAct" 模式下可用
directory_tree
- 获取文件和目录的递归树视图
- 输入：
  - path (string): 根路径
  - depth (number, optional): 递归的最大深度（默认值：1）
- 返回：
  - 表示目录树的 JSON 结构

文件管理

move_file
- 移动或重命名文件和目录
- 输入：
  - source (string): 源路径
  - destination (string): 目标路径
- 返回：
  - 确认消息
- 注意: 仅在 "mcpAct" 模式下可用
delete_multiple_files
- 在单个操作中删除多个文件
- 输入：
  - paths (string[]): 要删除的路径
- 返回：
  - 成功和失败的详细报告
- 注意: 仅在 "mcpAct" 模式下可用

实用工具

search_files
- 递归搜索与模式匹配的文件和目录
- 输入：
  - path (string): 要搜索的根路径
  - pattern (string): 要搜索的模式
  - excludePatterns (string[]): 要排除的模式
- 返回：
  - 匹配的文件路径数组
get_file_info
- 检索有关文件或目录的详细元数据
- 输入：
  - path (string): 要获取信息的路径
- 返回：
  - 详细的文件元数据（大小、日期、权限等）
list_allowed_directories
- 返回服务器允许访问的目录列表
- 输入：无
- 返回：
  - 允许的目录路径数组

Shell 操作

shell_exec
- 在 shell 中执行命令并将输出作为结构化数据返回
- 输入：
  - command (string): 要执行的命令
  - timeout (number, optional): 最大执行时间（毫秒）（默认值：5000）
- 返回：
  - 具有以下属性的 JSON 对象：
    - stdout (string): 来自命令的标准输出
    - stderr (string): 来自命令的标准错误输出
    - exitCode (number): 命令的退出代码（0 表示成功，非零表示失败）
- 注意:
- 仅当服务器以 --enableShellExecTool 标志启动时可用
- 仅在 "mcpAct" 模式下可用
- 具有可配置的超时，最大为 300 秒

模式管理

get_mode
- 获取当前操作模式
- 输入：无
- 返回：
  - 当前模式（“mcpAct”或“mcpPlan”）
set_mode
- 设置操作模式
- 输入：
  - mode (string): 要切换到的模式（“mcpAct”或“mcpPlan”）
- 返回：
  - 确认消息

与 Claude Desktop 一起使用

将其添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "aibd": {
      "command": "npx",
      "args": [
        "-y",
        "@gergelyszerovay/mcp-server-aibd-devcontainer",
        "--allowedDirectories=/your/allowed/path"
        // 如果要启用 shell 命令执行，请在此处添加 "--enableShellExecTool"
      ]
    }
  }
}

命令行选项

具有文件系统工具的 MCP 服务器。

选项
  --enableHttpTransport         启用 HTTP 传输 [默认值：false]
  --enableStdioTransport        启用 stdio 传输 [默认值：true]
  --enableRestServer            启用 REST API 服务器 [默认值：false]
  --enableShellExecTool              启用 shell 执行工具 [默认值：false]
  --mcpHttpPort=<port>          MCP HTTP 服务器的端口 [默认值：3001]
  --restHttpPort=<port>         REST HTTP 服务器的端口 [默认值：3002]
  --allowedDirectories=<path>   允许文件系统访问的目录（多个，必需）
  --initialMode=<mode>          初始操作模式：mcpAct 或 mcpPlan [默认值：mcpAct]
  --help                        显示此帮助消息

示例
  $ 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