File Writer MCP 서버

LM Studio 및 기타 MCP 호환 환경에서 원활한 파일 작업을 수행하기 위해 설계된 Model Context Protocol(MCP)의 Node.js 구현체입니다. 이 서버는 대규모 언어 모델이 일반 텍스트, 마크다운, CSV 및 Microsoft Excel(XLSX)을 포함한 여러 형식의 파일을 생성, 추가 및 관리할 수 있는 강력한 인터페이스를 제공합니다.

주요 기능

• 다중 형식 지원: .txt, .md, .csv, .xlsx 파일에 대한 데이터 변환을 처리합니다.

• 구조화된 데이터 처리: 테이블 데이터를 JSON 객체로 받아 요청된 형식으로 자동 변환합니다.

• 유연한 쓰기 모드:

  • 추가 (기본값): 기존 파일 끝에 새 데이터를 추가합니다.

  • 덮어쓰기: 기존 파일을 새 콘텐츠로 교체합니다.

  • 번호 매기기 백업: 증분 버전(예: file.1.csv)을 생성하여 기존 데이터를 보존합니다.

• 보안 중심: 모든 파일 작업을 사용자가 지정한 루트 디렉토리로 제한하여 무단 경로 탐색을 방지합니다.

• Excel 통합: ExcelJS를 활용하여 고품질의 바이너리 스프레드시트 파일을 생성합니다.

Related MCP server: Excel MCP Server

설치

사전 요구 사항

• Node.js (v18 이상)

• npm

설정

1. 저장소를 복제하거나 소스 파일을 로컬 컴퓨터에 복사합니다.

2. 필요한 종속성을 설치합니다:

   npm install

3. 프로젝트를 빌드합니다:

   npm run build

LM Studio 구성

LM Studio에서 이 서버를 사용하려면 다음 구성을 사용하여 MCP 설정에 추가하십시오:

{
  "mcpServers": {
    "file-writer": {
      "command": "node",
      "args": [
        "C:/Users/szpon/file_writer_mcp/dist/index.js",
        "--root",
        "C:/your/default/directory"
      ]
    }
  }
}

인수

• --root <path>: (필수) 상대 경로 파일 작업을 위한 기본 디렉토리의 절대 경로입니다.

• --overwrite: (선택 사항/레거시) 이전 구성과의 호환성을 위해 제공되며, 도구 선택 시 무시됩니다.

• --backup: (선택 사항/레거시) 이전 구성과의 호환성을 위해 제공되며, 도구 선택 시 무시됩니다.

도구 사용법

이 서버는 LM Studio 사이드바에서 직접 파일 처리를 명확하게 제어할 수 있도록 세 가지 고유한 도구를 제공합니다:

1. write_file: 표준 작업에 사용합니다. 기존 파일에 데이터를 추가하거나 파일이 없으면 새로 생성합니다.

2. write_file_overwrite: 기존 파일을 새 데이터로 완전히 교체할 때 사용합니다.

3. write_file_backup: 원본을 보존하면서 데이터를 저장할 때 사용합니다. 파일이 존재하면 번호가 매겨진 백업(예: data.1.csv)을 생성합니다.

도구 인수

• path (string): 파일 이름 또는 전체 절대 경로. 상대 경로가 제공되면 --root 디렉토리를 기준으로 해석됩니다. 절대 경로가 제공되면 서버는 해당 위치에 직접 씁니다.

• format (string): 원하는 파일 확장자 (txt, md, csv 또는 xlsx).

• data (object):

  • headers (string[]): 테이블 형식의 열 이름.

  • rows (any[][]): 작성할 데이터 세트.

  • content (string, 선택 사항): .txt 파일을 위한 일반 텍스트 콘텐츠.

개발

테스트 실행

이 프로젝트는 단위 테스트를 위해 Vitest를 사용합니다. 테스트 모음을 실행하려면:

npm test

빌드

TypeScript 소스를 배포 디렉토리로 컴파일하려면:

npm run build

라이선스

이 프로젝트는 LM Studio 및 기타 MCP 클라이언트와의 통합을 위해 있는 그대로 제공됩니다.