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

一个使大型语言模型能够列出、读取和修改文件系统中文件的服务器。

  • by quarkiverse
  • Java
  • 本地部署
  • 197 星标
  • 更新于
在 GitHub 查看 quarkiverse/quarkus-mcp-servers

使用说明

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

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

一般使用

  1. 安装 jbang的
  2. 配置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服务器支持的更多信息,请参阅此 博客文章 Quarkus MCP服务器 扩展文档.

启动它使用的服务器 jbang的 向 设置Java并尽可能透明地运行.jar。非常类似于如何 uvx, pipx, npmx 其他作品;仅适用于Java。