使用说明
文件系统的模型上下文协议服务器
此模型上下文协议(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服务器支持的更多信息,请参阅此 博客文章 Quarkus MCP服务器 扩展文档.
启动它使用的服务器 jbang的 向
设置Java并尽可能透明地运行.jar。非常类似于如何 uvx, pipx, npmx 其他作品;仅适用于Java。