mcpignore-filesystem MCP 서버

“mcpignore-filesystem” MCP 서버란 무엇인가요?

mcpignore-filesystem MCP 서버는 Node.js 기반의 도구로, AI 어시스턴트 개발 워크플로우에 안전하고 세분화된 파일시스템 접근 제어를 제공합니다. 표준 Filesystem MCP Server를 기반으로 .mcpignore 파일 지원을 추가하여, MCP 클라이언트(예: AI 에이전트)가 접근할 수 있는 파일과 디렉터리를 제한할 수 있습니다. .gitignore와 유사한 ignore 패턴을 지정해 민감한 데이터를 보호하고, 읽기, 쓰기, 디렉터리 관리, 검색 등의 작업에서 허가된 파일만 접근하도록 할 수 있습니다. 이 서버는 파일 관리가 필요한 개발 작업에 강력한 데이터 보안과 접근 통제를 유지하면서 AI 기반 워크플로우를 위한 맞춤화 가능한 파일시스템 인터페이스를 제공합니다.

프롬프트 목록

레포지토리에 프롬프트 템플릿이 명시되지 않았습니다.

리소스 목록

레포지토리에 명시적인 MCP 리소스가 문서화되어 있지 않습니다.

도구 목록

• read_file: .mcpignore 패턴과 일치하지 않는 파일을 읽음(무시된 경로는 차단).
• read_multiple_files: 무시되지 않은 여러 파일을 읽음(무시된 경로는 차단).
• write_file: 무시되지 않은 파일에 씀(무시된 경로는 차단).
• edit_file: 무시되지 않은 파일을 편집(무시된 경로는 차단).
• create_directory: 무시되지 않은 디렉터리를 생성(무시된 경로는 차단).
• list_directory: 무시되지 않은 디렉터리의 내용을 나열(무시된 경로는 차단).
• move_file: 무시되지 않은 파일 또는 디렉터리를 이동(무시된 경로는 차단).
• get_file_info: 무시되지 않은 파일의 메타데이터 조회(무시된 경로는 차단).
• directory_tree: 디렉터리 구조 조회(허용, 이름만 표시).
• search_files: 파일 검색(허용, 이름만 표시).
• list_allowed_directories: 접근이 허용된 디렉터리 목록(N/A, ignore 로직과 무관).

이 MCP 서버의 활용 사례

• 세분화된 파일시스템 보안: 개발자는 .mcpignore에 민감 파일(예: .env, 시크릿, 인증 정보 등)을 지정하여 AI 에이전트에게 프로젝트 디렉터리의 안전한 접근만 허용할 수 있습니다.
• 안전한 코드베이스 탐색: AI 도구가 대규모 코드베이스를 분석/탐색할 때, 비공개 또는 독점 파일 노출을 방지할 수 있습니다.
• 자동화된 파일 관리: .mcpignore를 통한 강력한 접근 제한으로 디렉터리 간 파일 정리, 검색, 이동 등 반복 작업을 자동화할 수 있습니다.
• 협업 개발 환경: 내부 또는 임시 파일 접근을 차단하면서, AI 어시스턴트가 공유 디렉터리 편집/검색을 안전하게 할 수 있습니다.
• 컴플라이언스 및 감사: 자동화 도구가 특정 데이터 유형 또는 파일에 접근하지 못하도록 하여 데이터 컴플라이언스를 강화하고 감사/거버넌스에 도움을 줍니다.

설치 방법

Windsurf

레포지토리에 별도의 Windsurf 안내가 제공되지 않았습니다.

Claude

1. Node.js와 npx가 설치되어 있는지 확인하세요.
2. claude_desktop_config.json을 여세요.
3. 아래와 같이 MCP 서버 설정을 추가하세요.
4. 파일을 저장하고 Claude를 재시작하세요.
5. 서버가 정상적으로 동작하는지 확인하세요.

{
  "mcpServers": {
    "mcpignore-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@cyberhaven/mcpignore-filesystem",
        "/Users/<username>/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

API 키 보안 적용 예시:

{
  "mcpServers": {
    "mcpignore-filesystem": {
      "command": "npx",
      "args": [ ... ],
      "env": {
        "API_KEY": "${MCP_SERVER_API_KEY}"
      },
      "inputs": {
        "api_key": "${MCP_SERVER_API_KEY}"
      }
    }
  }
}

Cursor

1. Node.js와 npx가 설치되어 있는지 확인하세요.
2. mcp.json 설정 파일을 여세요.
3. 아래와 같이 서버 설정을 추가하세요.
4. 파일을 저장하고 Cursor를 재시작하세요.
5. 서버 연결을 확인하세요.

{
  "mcpServers": {
    "mcpignore-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@cyberhaven/mcpignore-filesystem",
        "/Users/<username>/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

API 키 보안: (위 Claude 예시 참고)

Cline

1. Node.js와 npx가 설치되어 있는지 확인하세요.
2. cline_mcp_settings.json을 여세요.
3. 서버 설정을 추가하세요.
4. 저장 후 Cline을 재시작하세요.
5. 서버가 정상 동작하는지 확인하세요.

{
  "mcpServers": {
    "mcpignore-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@cyberhaven/mcpignore-filesystem",
        "/Users/<username>/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

API 키 보안: (위 Claude 예시 참고)

Windsurf

설치 안내가 제공되지 않았습니다.

플로우 내에서 MCP 사용법

FlowHunt에서 MCP 사용하기

MCP 서버를 FlowHunt 워크플로우에 통합하려면, 플로우에 MCP 컴포넌트를 추가하고 AI 에이전트와 연결하세요:

MCP 컴포넌트를 클릭해 설정 패널을 열고, 시스템 MCP 설정 섹션에 다음과 같이 MCP 서버 정보를 JSON 형식으로 입력하세요:

{
  "mcpignore-filesystem": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

설정이 완료되면 AI 에이전트가 이 MCP를 도구로 사용하며 모든 기능을 활용할 수 있습니다. “mcpignore-filesystem"을 실제 MCP 서버 이름으로, URL은 본인의 MCP 서버 URL로 변경하는 것을 잊지 마세요.

개요

제공된 정보를 기반으로 이 MCP 서버는 강력하고 명확히 문서화된 파일시스템 도구와 보안 기능을 갖추고 있지만, 프롬프트 및 리소스 템플릿이 부족합니다. Roots 또는 샘플링 지원에 대한 언급도 없습니다. 따라서, 안전한 파일 관리에는 탁월하지만 프롬프트 템플릿이나 고급 리소스 처리가 필요한 워크플로우에는 다소 부족할 수 있습니다.

MCP 점수

평가:
이 MCP 서버의 점수는 6/10입니다. 보안 중심, 도구 및 라이선스 문서화는 명확하나, 프롬프트 템플릿, 리소스 정의, roots/샘플링 지원 증거가 부족합니다. ignore 기반의 안전한 파일시스템 접근이 필요한 팀에게 가장 적합합니다.