local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides access to the local file system, enabling listing, reading, and modifying files in user-specified directories.

文件系统的模型上下文协议服务器

该模型上下文协议 (MCP) 服务器使大型语言模型 (LLM) 能够列出、读取和修改文件系统中的文件。

一般用法

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

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

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

Claude 桌面配置和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 框架及其模型上下文协议支持。

如果您想了解有关 Quarkus MCP Server 支持的更多信息，请参阅此博客文章和 Quarkus MCP Server扩展文档。

为了启动服务器，它使用jbang设置 Java 并尽可能透明地运行 .jar 文件。其工作方式与uvx 、 pipx 、 npmx和其他库非常相似；只不过是针对 Java 的。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

浏览、列出和编辑文件系统。使用 Java/Quarkus 实现，提供原生镜像（速度快！）

Related Resources

Reddit Discussion about this server