Local Code MCP

Local Code MCP는 Windows 로컬 폴더의 프로그램 코드를 ChatGPT/MCP에서 안전하게 확인, 수정, 검증, 패키징하기 위한 로컬 MCP 서버입니다.

기존의 ZIP 업로드 → 수정 → ZIP 재생성 방식 대신, C:/hwpmcp, C:/OfficeMCP 같은 허용 폴더를 직접 연결해서 다음 작업을 수행하도록 설계했습니다.

• 로컬 프로젝트 파일 목록 확인

• 코드 파일 읽기

• 파일명/본문 검색

• 안전한 텍스트 패치 및 dry-run diff 확인

• 수정 전 자동 백업

• Git status/diff 확인

• 허용된 테스트 명령 실행

• 변경사항 .md 생성

• 수정 파일 ZIP 생성

핵심 안전장치

1. config.json의 allowed_roots 안에 있는 폴더만 접근합니다.

2. .env, 개인키, Windows 시스템 폴더 등은 기본 차단합니다.

3. 코드 수정 전 백업을 생성합니다.

4. 기본 수정은 dry_run으로 diff를 먼저 확인할 수 있습니다.

5. 명령 실행은 allowlist에 등록된 명령만 허용합니다.

6. 삭제 기능은 기본 구현하지 않았습니다.

Related MCP server: github-mcp

설치

Python 3.10 이상을 권장합니다.

cd C:\local-code-mcp
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e .
pip install "mcp>=1.0.0"

설정

처음에는 예시 설정 파일을 만듭니다.

local-code-mcp init-config config.json

config.json에서 허용할 폴더를 확인합니다.

{
  "allowed_roots": [
    "C:/hwpmcp",
    "C:/OfficeMCP"
  ]
}

CLI 사용 예시

파일 목록:

local-code-mcp --config config.json list C:/hwpmcp --max-depth 3

본문 검색:

local-code-mcp --config config.json search-text C:/hwpmcp table_created

수정 전 dry-run:

local-code-mcp --config config.json replace C:/hwpmcp/server.py --old "status: success" --new "status: error"

실제 적용:

local-code-mcp --config config.json replace C:/hwpmcp/server.py --old "status: success" --new "status: error" --apply --project-root C:/hwpmcp

문법 검사:

local-code-mcp --config config.json compile C:/hwpmcp

Git diff:

local-code-mcp --config config.json git-diff C:/hwpmcp

변경사항 문서 생성:

local-code-mcp --config config.json changelog C:/hwpmcp --request-summary "표 생성 오류 수정"

ZIP 생성:

local-code-mcp --config config.json zip C:/hwpmcp --include-files-json '["server.py"]'

MCP 서버 실행

$env:LOCAL_CODE_MCP_CONFIG="C:\local-code-mcp\config.json"
python -m local_code_mcp.server

MCP 클라이언트에는 stdio 서버로 등록합니다. 예시:

{
  "mcpServers": {
    "local-code-mcp": {
      "command": "python",
      "args": ["-m", "local_code_mcp.server"],
      "env": {
        "LOCAL_CODE_MCP_CONFIG": "C:/local-code-mcp/config.json"
      }
    }
  }
}

제공 MCP 도구

• list_allowed_roots

• create_example_config

• mcp_list_project_files

• mcp_read_file

• mcp_write_file_safe

• mcp_search_files

• mcp_search_text

• mcp_get_file_info

• mcp_replace_in_file

• mcp_restore_from_backup

• mcp_run_command_safely

• mcp_run_compile_check

• mcp_run_pytest

• mcp_git_status

• mcp_git_diff

• mcp_git_changed_files

• mcp_git_create_branch

• mcp_git_restore_file

• mcp_detect_project_type

• mcp_summarize_project

• mcp_generate_changelog_md

• mcp_create_change_zip

• mcp_create_full_snapshot_zip

현재 버전의 한계

• GUI 프로그램을 직접 클릭하는 기능은 포함하지 않았습니다. 코드 수정은 파일시스템 기반으로 처리합니다.

• 통합 대상 MCP 클라이언트의 등록 방식은 환경에 따라 다를 수 있습니다.

• mcp Python 패키지 버전에 따라 서버 실행 방식 조정이 필요할 수 있습니다.

• 보안상 전체 C드라이브 접근은 권장하지 않습니다.

권장 운영 방식

1. allowed_roots를 필요한 프로젝트 폴더로만 제한합니다.

2. 먼저 dry_run으로 diff를 확인합니다.

3. 수정 전 Git 상태를 확인합니다.

4. 수정 후 compile, pytest, git-diff를 실행합니다.

5. 변경사항 .md와 ZIP을 생성합니다.