클로드-코드-mcp 프로젝트

업데이트

이제 이 MCP 서버는 npx를 통한 로컬 설치 없이도 작동합니다!!

개요

claude-code-mcp 프로젝트는 Claude Code의 MCP 서버입니다.

로컬에 설치된 Claude Code 명령을 호출하고 explain_code , review_code , fix_code , edit_code , test_code , simulate_command , your_own_query 등의 도구를 제공합니다. 이 서버는 Node.js와 MCP SDK를 사용하여 구현되었으며, stdio를 통해 클라이언트로부터 JSON 형식 요청을 받습니다. 내부적으로는 Base64 인코딩을 사용하여 자연어 텍스트의 특수 문자(줄바꿈, 따옴표 등)를 원활하게 처리하여 안정성과 유연성을 향상시킵니다. 주요 역할은 요청 수신, 입력 인코딩, 명령 생성 및 실행, 그리고 JSON 형식으로 실행 결과를 반환하는 것입니다. 이 프로젝트는 Claude Code CLI 환경(Ubuntu/WSL2 등)에서 작동하는 것으로 확인되었습니다.

💡 LLM 성능이 떨어지는 MCP 호스트도 클로드의 힘을 길들이고 활용할 수 있습니다💪! claude-code-mcp를 사용하면 클로드 데스크톱에서 클로드 코드를 호출할 수도 있습니다!! 😇😜😎 (미확인)

기능

서버의 주요 역할은 다음과 같습니다.

요청 수신: 클라이언트로부터 JSON 형식 도구 요청을 수신합니다(예: code , context , focus_areas 등).
입력 처리: 수신된 자연어 텍스트를 내부적으로 Base64로 인코딩합니다.
도구 선택 및 명령 생성: 요청의 도구 이름을 기반으로 고정 템플릿이나 자유 형식( your_own_query )을 사용하여 쿼리에 대한 명령 문자열을 조립합니다.
명령 실행: Node.js의 child_process.spawn 사용하여 조립된 명령을 실행하고 표준 출력에서 결과를 얻습니다.
결과 반환: 실행 결과를 JSON 형식으로 클라이언트에 반환합니다.

시작하기

필수 조건

Node.js(v18 이상 권장, v22.14.0으로 테스트)
npm(또는 yarn)
Claude Code 명령이 설치되고 인증이 완료되었습니다. https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview

설치 및 사용

claude-code-mcp 사용하는 방법에는 여러 가지가 있습니다.

1. npx 사용 (빠른 사용을 위해 권장)

npx 사용하면 설치 없이 서버를 직접 실행할 수 있습니다.

지엑스피1

2. 글로벌 설치

패키지를 전역으로 설치합니다.

npm install -g claude-code-mcp

그런 다음 명령으로 실행할 수 있습니다.

claude-code-mcp

3. 로컬 설치(개발용)

저장소를 복제하고 종속성을 설치합니다.

git clone https://github.com/KunihiroS/claude-code-mcp.git
cd claude-code-mcp/claude-code-server
npm install
npm run build

그런 다음 빌드된 스크립트를 직접 실행할 수 있습니다.

node build/index.js

구성

환경 변수:

설치 방법에 관계없이 환경 변수를 구성해야 합니다. 다음 파일 중 하나를 생성하세요.

MCP 호스트 설정 사용( npx 권장): MCP 호스트 설정에서 직접 환경 변수를 구성하세요(아래 "MCP 호스트 구성" 참조). npx 사용할 때 가장 쉬운 방법입니다.
.env 파일 사용: npx @kunihiros/claude-code-mcp 명령을 실행하는 디렉토리에 .env 파일을 만듭니다.
글로벌 구성 파일 사용: 홈 디렉토리( ~/.claude-code-mcp.env )에 .claude-code-mcp.env 파일을 만듭니다.

파일( .env 또는 ~/.claude-code-mcp.env )을 사용하는 경우 다음 내용을 추가하고 CLAUDE_BIN 경로를 조정합니다.

# .env or ~/.claude-code-mcp.env
CLAUDE_BIN=/path/to/your/claude/executable  # REQUIRED: Set the full path to your Claude CLI
LOG_LEVEL=info                             # Optional: Set log level (e.g., debug, info, warn, error)

MCP 호스트 구성( npx 에 권장):

MCP 호스트 애플리케이션 설정(예: Claude Desktop 설정)에 다음을 추가하세요. 이 방법을 사용하면 환경 변수를 직접 설정할 수 있습니다.

    "claude-code-server": {
      "command": "npx",
      "args": [
        "-y",
        "@kunihiros/claude-code-mcp"
      ],
      "env": {
        "CLAUDE_BIN": "/path/to/your/claude/executable", // REQUIRED: Set the absolute path
        "LOG_LEVEL": "info"                             // Optional: Set log level
      },
      "disabled": false
    }

(호스트 애플리케이션을 다시 시작해야 할 수도 있습니다.)

대체 MCP 호스트 구성(글로벌 설치/로컬 개발):

패키지를 전역적으로 설치했거나 복제된 저장소에서 로컬로 실행 중이고 claude-code-mcp 명령이 시스템의 PATH에 있는 경우 다음을 사용할 수 있습니다.

    "claude-code-server": {
      "command": "claude-code-mcp",
      "disabled": false
    }

이 경우 위에서 설명한 대로 .env 파일이나 글로벌 ~/.claude-code-mcp.env 파일을 사용하여 환경 변수를 구성 해야 합니다 .

환경 변수 세부 정보

이 서버는 다음 환경 변수를 사용합니다(MCP 호스트 env 설정, .env 또는 ~/.claude-code-mcp.env 를 통해 설정됨):

CLAUDE_BIN : Claude CLI 실행 파일의 경로를 지정합니다. (필수) 예: /home/linuxbrew/.linuxbrew/bin/claude 또는 C:\Users\YourUser\AppData\Local\bin\claude.exe
LOG_LEVEL : 로그 수준을 지정합니다. (선택 사항, 기본값은 info 입니다.) 가능한 값: debug , info , warn , error .

사용 가능한 도구

claude-code-mcp 서버는 다음과 같은 도구를 제공합니다.

explain_code : 주어진 코드에 대한 자세한 설명을 제공합니다.
review_code : 주어진 코드를 검토합니다.
fix_code : 주어진 코드의 버그나 문제를 수정합니다.
edit_code : 지침에 따라 주어진 코드를 편집합니다.
test_code : 주어진 코드에 대한 테스트를 생성합니다.
simulate_command : 주어진 명령의 실행을 시뮬레이션합니다.
your_own_query : 컨텍스트를 포함한 사용자 정의 쿼리를 보냅니다.

메모

로그 파일( claude-code-mcp.log ) 위치:
- 먼저 프로젝트 루트에 생성을 시도합니다.
- 사용자의 홈 디렉토리( ~/.claude-code-mcp.log )로 돌아갑니다.
- 마지막으로 /tmp/claude-code-mcp.log 로 돌아갑니다.
로그 회전은 아직 구현되지 않았습니다(로그 파일 크기에 주의하세요).
주로 Ubuntu/WSL2에서 Claude CLI로 테스트되었습니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 아래를 참조하세요.

MIT License

Copyright (c) 2024 KunihiroS

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

부인 성명

이 소프트웨어는 교육 및 연구 목적으로만 제공됩니다. 이 프로젝트는 Anthropic과 공식적으로 제휴하거나 보증하지 않습니다. Claude는 Anthropic의 상표입니다.

이 프로젝트는 Claude CLI를 종속성으로 사용하지만, 독립적인 커뮤니티 주도 프로젝트입니다. 사용자는 이 프로젝트를 사용할 때 Anthropic의 서비스 약관을 준수해야 합니다.

이 프로젝트의 유지 관리자는 소프트웨어의 오용이나 제3자 API 또는 서비스의 서비스 약관 위반에 대해 책임을 지지 않습니다.

claude-code-mcp