文件系统Model Context Protocol服务器

此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。