JavaScript MCP Server

JavaScript MCP 서버(js-mcp)

AI 어시스턴트가 상태 저장 REPL 세션으로 JavaScript 코드를 실행할 수 있게 해주는 MCP(Model Context Protocol) 서버입니다.

특징

핵심 기능

• 일회성 JavaScript 실행 : Node.js에서 JavaScript 코드를 직접 실행합니다.
• 상태 저장 REPL 세션 : 여러 실행에 걸쳐 변수와 컨텍스트 유지
• 파일 시스템 작업 : 파일 읽기, 쓰기 및 조작
• 패키지 관리 : 모듈 가져오기 및 npm 패키지 관리

고급 기능

• 안전한 샌드박스 실행
• 비동기 코드 지원
• 포맷된 스택 추적을 통한 오류 처리
• 자동 정리를 통한 세션 관리

설치

지엑스피1

용법

stdio 전송으로 실행(Claude Desktop과 함께 사용)

HTTP 전송으로 실행

사용 가능한 도구

JavaScript 실행

• execute_javascript : 기본 샌드박스에서 JavaScript 코드 실행
• execute_javascript_with_modules : 모듈 가져오기로 JavaScript 실행
• execute_javascript_async : 비동기 JavaScript 코드 실행

REPL 세션

• repl_create_session : 새로운 REPL 세션을 생성합니다
• repl_execute : REPL 세션에서 코드 실행
• repl_get_context : 세션에서 변수 값을 가져옵니다.
• repl_delete_session : 세션 삭제
• repl_list_sessions : 모든 활성 세션을 나열합니다.

파일 작업

• file_read : 파일 내용을 읽습니다
• file_write : 파일에 내용을 씁니다.
• file_list : 디렉토리의 파일 목록
• file_delete : 파일이나 디렉토리를 삭제합니다.
• file_exists : 파일이 존재하는지 확인합니다

패키지 관리

• package_check : 모듈이 사용 가능한지 확인합니다.
• package_install : npm 패키지 설치
• package_list : 설치된 패키지 목록

보안

서버는 안전 기능을 갖춘 직접 JavaScript 실행을 사용합니다.

• 코드 실행에 대한 시간 제한
• 파일 시스템 액세스는 작업 디렉토리로 제한됨
• 위험한 작업을 방지하기 위한 경로 검증

구성

환경 변수를 설정하여 서버를 구성합니다.

• PORT : HTTP 서버 포트(기본값: 3000)
• WORKING_DIRECTORY : 파일 작업을 위한 기본 디렉토리(기본값: 현재 디렉토리)
• SESSION_TIMEOUT : REPL 세션 시간 초과(분) (기본값: 30)

개발

특허

MIT