MCP File Tools

Claude Desktop에서 사용할 수 있는 파일 시스템 작업을 위한 MCP 도구입니다.

설치

npm install mcp-file-tools

사용 가능한 도구들

1. 파일 쓰기 (write-test-data)

파일을 생성하고 내용을 씁니다.

{
  "tool": "write-test-data",
  "params": {
    "text": "파일에 쓸 내용",
    "filename": "test.txt"
  }
}

2. 파일 읽기 (read-test-data)

파일의 내용을 읽습니다.

{
  "tool": "read-test-data",
  "params": {
    "filename": "test.txt"
  }
}

3. 파일 목록 보기 (list-test-data)

현재 디렉토리의 모든 파일을 나열합니다.

{
  "tool": "list-test-data",
  "params": {}
}

4. 파일 삭제 (delete-test-data)

파일을 삭제합니다.

{
  "tool": "delete-test-data",
  "params": {
    "filename": "test.txt"
  }
}

제한사항

• 허용된 파일 확장자: .txt, .json, .md
• 최대 파일 크기: 1MB
• 모든 파일은 ~/.mcp-test-app 디렉토리에 저장됩니다
• 파일 이름에는 특수문자가 허용되지 않습니다

Node.js가 없는 사용자를 위한 대안:

1. 독립 실행 파일로 변환: pkg나 nexe 같은 도구를 사용하여 Node.js 애플리케이션을 독립 실행 파일로 변환 사용자는 Node.js 없이도 실행 가능

npm install -g pkg
pkg server.js --targets node18-win-x64 --output mcp-file-tools.exe

2) Docker 컨테이너로 제공:

Docker 이미지로 패키징 Docker만 설치되어 있으면 실행 가능

FROM node:18
WORKDIR /app
COPY . .
RUN npm install
CMD ["node", "server.js"]

웹 서비스로 제공:

서버를 클라우드에 호스팅 사용자는 HTTP API로 접근 Node.js 설치 불필요