파일 시스템을 위한 모델 컨텍스트 프로토콜 서버

이 모델 컨텍스트 프로토콜(MCP) 서버는 대규모 언어 모델(LLM)이 파일 시스템에서 파일을 나열하고, 읽고, 수정할 수 있도록 합니다.

일반적인 사용법

1. jbang 설치

2. 서버를 실행하도록 MCP 클라이언트를 구성하세요(아래 Claude Desktop Config 참조)

다음 명령을 사용하여 특정 경로에 대한 액세스 권한을 부여하여 서버를 시작합니다.

지엑스피1

Related MCP server: Databricks MCP Server

Claude Desktop Config 및 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, Supersonic Subatomic Java Framework 및 해당 Model Context Protocol 지원을 사용합니다.

Quarkus MCP 서버 지원에 대해 자세히 알아보려면 이 블로그 게시물 과 Quarkus MCP 서버 확장 설명서를 참조하세요.

서버를 실행하려면 jbang을 사용하여 Java를 설정하고 .jar 파일을 최대한 투명하게 실행합니다. uvx , pipx , npmx 등의 작동 방식과 매우 유사하며, Java에서만 작동합니다.