Model Context Protocol Server for filesystem

这个 Model Context Protocol (MCP) 服务器使大型语言模型 (LLMs) 能够列出、读取和修改文件系统中的文件。

通用用法

1. 安装 jbang
2. 配置您的 MCP 客户端以运行服务器（请参阅下面的 Claude Desktop Config）

使用以下命令启动具有特定路径访问权限的服务器。

jbang filesystem@quarkiverse/quarkus-mcp-servers ~/code/quarkiverse ~/code/jbang 

Claude Desktop 配置和 mcp-cli

将以下内容添加到您的 claude_desktop_config.json 或 server_config.json 文件中：

{
  "mcpServers": {
    "filesystem": {
      "command": "jbang",
      "args": [
        "filesystem@quarkiverse/quarkus-mcp-servers",
        "[path1]",
        "[path2]"
      ]
    }
  }
}

原生镜像/可执行文件

使用原生镜像，启动时间几乎是即时的。

您可以从 发布页面 下载原生镜像。

然后在您的 MCP 客户端中使用适合您平台的可执行文件。

例如，在 MacOS arm64 (M1, M2 等) 上：

{
  "mcpServers": {
    "filesystem": {
      "command": "jbang",
      "args": [
        "mcp-server-filesystem-osx-aarch_64",
        "[path1]",
        "[path2]"
      ]
    }
  }
}

当然，您也可以将可执行文件重命名为其他名称，比如 mcp-server-filesystem 如果您愿意的话。

故障排除

找不到 jbang

• 确保您已安装 jbang 并且它在您的 PATH 中可用
• 或者，使用 jbang 可执行文件的完整路径（例如 /Users/username/.jbang/jbang）

获取更多日志

要获得更详细的日志，可以在 jbang 命令行中添加以下参数：

-Dquarkus.log.file.enable=true -Dquarkus.log.file.path=${user.home}/mcp-server-filesystem.log

示例：

jbang -Dquarkus.log.file.enable=true -Dquarkus.log.file.path=${user.home}/mcp-server-filesystem.log filesystem@quarkiverse/quarkus-mcp-servers [path1] [path2] ...

这是如何实现的？

MCP 服务器使用 Quarkus，这是一个超音速亚原子 Java 框架及其 Model Context Protocol 支持。

如果您想了解更多关于 Quarkus MCP 服务器支持的信息，请参阅这篇 博客文章
和 Quarkus MCP 服务器 扩展文档。

为了启动服务器，它使用 jbang 来
设置 Java 并尽可能透明地运行 .jar。这与 uvx、pipx、npmx 等工作方式非常相似；只是针对 Java。