Claude Code MCP Server

클로드 코드 MCP 서버

Claude Code를 원샷 모드로 실행하고 권한을 자동으로 우회할 수 있는 MCP(Model Context Protocol) 서버입니다.

Cursor가 복잡하고 여러 단계로 이루어진 편집이나 작업에 어려움을 겪는 경우가 있다는 것을 알고 계셨나요? 강력한 통합 claude_code 도구를 갖춘 이 서버는 Claude를 코딩 작업에 더욱 직접적이고 유능한 에이전트로 만들어 줍니다.

개요

이 MCP 서버는 LLM이 Claude Code와 상호 작용하는 데 사용할 수 있는 하나의 도구를 제공합니다. Claude Desktop 또는 다른 MCP 클라이언트와 통합하면 LLM은 다음과 같은 작업을 수행할 수 있습니다.

• --dangerously-skip-permissions 사용하여 모든 권한을 우회하여 Claude Code를 실행합니다.
• 권한 중단 없이 모든 프롬프트에서 Claude 코드 실행
• 파일 편집 기능에 직접 액세스
• 기본적으로 특정 도구 활성화

이익

• Claude/Windsurf는 파일 편집에 어려움을 겪는 경우가 많습니다. Claude Code는 더 빠르고 더 나은 편집 기능을 제공합니다.
• 직접 실행하는 대신 여러 명령을 대기열에 넣을 수 있습니다. 이렇게 하면 컨텍스트 공간이 절약되어 더 중요한 내용이 더 오래 유지되고 압축이 줄어듭니다.
• 파일 작업, Git 또는 기타 작업에는 비용이 많이 드는 모델이 필요하지 않습니다. Antropic Max에 가입하면 Claude Code는 비용 효율적입니다. Max 모드에서 Gemini나 O3를 사용하면 더 저렴한 모델로 작업을 이전하여 비용을 절약할 수 있습니다.
• 클로드는 시스템 접근 권한이 더 넓어 커서/윈드서프가 할 수 없는(또는 할 수 없다고 생각하는) 일을 할 수 있으므로, 막혔을 때 "클로드 코드 사용"이라고 말하면 대개 문제가 해결됩니다.
• 에이전트 규칙의 에이전트.

필수 조건

• Node.js v20 이상(fnm 또는 nvm을 사용하여 설치)
• Claude CLI를 로컬에 설치(실행하고 /doctor를 호출)하고 -dangerously-skip-permissions 수락했습니다.

구성

환경 변수

• CLAUDE_CLI_NAME : Claude CLI 바이너리 이름을 재정의하거나 절대 경로를 제공합니다(기본값: claude ). 이를 통해 사용자 지정 Claude CLI 바이너리를 사용할 수 있습니다. 이 옵션은 다음과 같은 경우에 유용합니다.
  • 사용자 정의 Claude CLI 래퍼 사용
  • 모의 바이너리로 테스트
  • 여러 Claude CLI 버전을 나란히 실행

  지원되는 형식:

  • 간단한 이름: CLAUDE_CLI_NAME=claude-custom 또는 CLAUDE_CLI_NAME=claude-v2
  • 절대 경로: CLAUDE_CLI_NAME=/path/to/custom/claude

  상대 경로(예: ./claude 또는 ../claude )는 허용되지 않으며 오류가 발생합니다.

  간단한 이름으로 설정하면 서버는 다음에서 지정된 바이너리를 찾습니다.

  1. 시스템 PATH(기본 claude 명령 대신)

  참고: 로컬 사용자 설치 경로( ~/.claude/local/claude )는 계속 확인되지만 기본 claude 바이너리에 대해서만 확인됩니다.

• MCP_CLAUDE_DEBUG : 디버그 로깅을 활성화합니다(자세한 출력을 위해 true 로 설정).

설치 및 사용

이 서버를 사용하려면 npx 사용하여 설치하는 것이 좋습니다.

지엑스피1

사용자 정의 Claude CLI 바이너리 이름을 사용하려면 환경 변수를 지정하면 됩니다.

중요한 첫 번째 설정: 권한 수락

MCP 서버가 claude_code 도구를 성공적으로 사용하려면 먼저 --dangerously-skip-permissions 플래그를 사용하여 Claude CLI를 수동으로 한 번 실행하고 로그인한 다음 약관에 동의해야 합니다.

이는 Claude CLI의 일회성 요구 사항입니다.

안내에 따라 수락하세요. 수락이 완료되면 MCP 서버가 비대화형으로 플래그를 사용할 수 있게 됩니다.

macOS에서 도구를 처음 실행할 때 모든 종류의 폴더 권한을 요청할 수 있으며, 그 후 첫 번째 실행은 실패합니다. 이후 실행은 정상적으로 작동합니다.

MCP 클라이언트에 연결

서버를 설정한 후에는 MCP 클라이언트(Cursor 또는 mcp.json 이나 mcp_config.json 사용하는 다른 클라이언트)를 구성해야 합니다.

MCP 구성 파일

구성은 일반적으로 JSON 파일로 이루어집니다. 이름과 위치는 클라이언트에 따라 다를 수 있습니다.

커서

커서는 mcp.json 사용합니다.

• macOS: ~/.cursor/mcp.json
• 윈도우: %APPDATA%\\Cursor\\mcp.json
• 리눅스: ~/.config/cursor/mcp.json

윈드서핑

Windsurf 사용자는 mcp_config.json 사용합니다.

• macOS: ~/.codeium/windsurf/mcp_config.json
• 윈도우: %APPDATA%\\Codeium\\windsurf\\mcp_config.json
• 리눅스: ~/.config/.codeium/windsurf/mcp_config.json

(참고: 일부 혼합 설정에서 Cursor도 설치되어 있으면 이러한 클라이언트는 Cursor의 ~/.cursor/mcp.json 경로를 다시 사용할 수 있습니다. Codeium 확장 기능을 사용하는 경우 Codeium 관련 경로를 우선시하세요.)

이 파일이 없으면 만드세요. claude_code 에 대한 설정을 추가하거나 업데이트하세요.

제공된 도구

이 서버는 하나의 주요 도구를 제공합니다.

claude_code

--dangerously-skip-permissions 옵션을 사용하여 Claude Code CLI를 직접 실행합니다.

인수:

• prompt (문자열, 필수): Claude Code에게 보낼 프롬프트입니다.
• options (객체, 선택 사항):
  • tools (문자열 배열, 선택 사항): 활성화할 특정 Claude 도구(예: Bash , Read , Write ). 일반적인 도구는 기본적으로 활성화됩니다.

MCP 요청 예시:

예시

서버가 실제로 작동하는 모습을 보여주는 몇 가지 시각적 예는 다음과 같습니다.

ESLint 설정 수정

다음은 Claude Code MCP 도구를 사용하여 기존 구성 파일을 삭제하고 새 구성 파일을 만들어 ESLint 설정을 대화형으로 수정하는 예입니다.

파일 목록 예제

다음은 Claude Code 도구가 디렉토리의 파일을 나열하는 예입니다.

주요 사용 사례

이 서버는 통합된 claude_code 도구를 통해 AI가 Claude Code CLI에 직접 접근할 수 있도록 하여 다양하고 강력한 기능을 제공합니다. 다음은 이러한 기능을 활용할 수 있는 몇 가지 예입니다.

1. 코드 생성, 분석 및 리팩토링:
   • "Generate a Python script to parse CSV data and output JSON."
   • "Analyze my_script.py for potential bugs and suggest improvements."
2. 파일 시스템 작업(생성, 읽기, 편집, 관리):
   • 파일 생성: "Your work folder is /Users/steipete/my_project\n\nCreate a new file named 'config.yml' in the 'app/settings' directory with the following content:\nport: 8080\ndatabase: main_db"
   • 파일 편집: "Your work folder is /Users/steipete/my_project\n\nEdit file 'public/css/style.css': Add a new CSS rule at the end to make all 'h2' elements have a 'color: navy'."
   • 이동/복사/삭제: "Your work folder is /Users/steipete/my_project\n\nMove the file 'report.docx' from the 'drafts' folder to the 'final_reports' folder and rename it to 'Q1_Report_Final.docx'."
3. 버전 제어(Git):
   • "Your work folder is /Users/steipete/my_project\n\n1. Stage the file 'src/main.java'.\n2. Commit the changes with the message 'feat: Implement user authentication'.\n3. Push the commit to the 'develop' branch on origin."
4. 터미널 명령 실행:
   • "Your work folder is /Users/steipete/my_project/frontend\n\nRun the command 'npm run build'."
   • "Open the URL https://developer.mozilla.org in my default web browser."
5. 웹 검색 및 요약:
   • "Search the web for 'benefits of server-side rendering' and provide a concise summary."
6. 복잡한 다단계 워크플로:
   • 버전 범프 자동화, 변경 로그 업데이트, 릴리스 태그 지정: "Your work folder is /Users/steipete/my_project\n\nFollow these steps: 1. Update the version in package.json to 2.5.0. 2. Add a new section to CHANGELOG.md for version 2.5.0 with the heading '### Added' and list 'New feature X'. 3. Stage package.json and CHANGELOG.md. 4. Commit with message 'release: version 2.5.0'. 5. Push the commit. 6. Create and push a git tag v2.5.0."
7. 구문 오류가 있는 파일 복구:
   • "Your work folder is /path/to/project\n\nThe file 'src/utils/parser.js' has syntax errors after a recent complex edit that broke its structure. Please analyze it, identify the syntax errors, and correct the file to make it valid JavaScript again, ensuring the original logic is preserved as much as possible."
8. GitHub와 상호 작용(예: 풀 리퀘스트 생성):
   • "Your work folder is /Users/steipete/my_project\n\nCreate a GitHub Pull Request in the repository 'owner/repo' from the 'feature-branch' to the 'main' branch. Title: 'feat: Implement new login flow'. Body: 'This PR adds a new and improved login experience for users.'"
9. GitHub와 상호 작용(예: PR CI 상태 확인):
   • "Your work folder is /Users/steipete/my_project\n\nCheck the status of CI checks for Pull Request #42 in the GitHub repository 'owner/repo'. Report if they have passed, failed, or are still running."

GitHub Actions 워크플로 수정

복잡한 다단계 작업

이 예제는 claude_code 브랜치를 만들어 릴리스를 준비하고, 여러 파일( package.json , CHANGELOG.md )을 업데이트하고, 변경 사항을 커밋하고, 풀 리퀘스트를 시작하는 등 보다 복잡하고 여러 단계로 구성된 작업을 단일하고 일관된 작업으로 처리하는 방법을 보여줍니다.

중요: 파일 시스템이나 git 작업에 대한 프롬프트에서 현재 작업 디렉터리(CWD) 컨텍스트를 제공하는 것을 잊지 마세요(예: "Your work folder is /path/to/project\n\n...your command..." ).

문제 해결

• "명령을 찾을 수 없습니다"(claude-code-mcp): 전역으로 설치된 경우, npm 전역 bin 디렉터리가 시스템 PATH에 있는지 확인하세요. npx 사용하는 경우, npx 자체가 작동하는지 확인하세요.
• "명령을 찾을 수 없습니다"(claude 또는 ~/.claude/local/claude): Claude CLI가 올바르게 설치되었는지 확인하세요. claude/doctor 실행하거나 관련 설명서를 확인하세요.
• 권한 문제: "중요한 최초 설정" 단계를 실행했는지 확인하세요.
• 서버의 JSON 오류: MCP_CLAUDE_DEBUG 가 true 이면 오류 메시지나 로그가 MCP의 JSON 파싱을 방해할 수 있습니다. 정상적인 작동을 위해서는 false 로 설정하세요.
• ESM/가져오기 오류: Node.js v20 이상을 사용하고 있는지 확인하세요.

개발자를 위한: 로컬 설정 및 기여

이 서버를 개발하거나 이 서버에 기여하거나 테스트를 위해 복제된 저장소에서 실행하려면 로컬 설치 및 개발 설정 가이드를 참조하세요.

테스트

이 프로젝트에는 포괄적인 테스트 모음이 포함되어 있습니다.

자세한 테스트 문서는 E2E 테스트 가이드를 참조하세요.

환경 변수를 통한 구성

다음 환경 변수를 사용하여 서버의 동작을 사용자 지정할 수 있습니다.

• CLAUDE_CLI_PATH : Claude CLI 실행 파일의 절대 경로입니다.
  • 기본값: ~/.claude/local/claude 확인한 다음 claude 로 돌아갑니다(PATH에 있을 것으로 예상).
• MCP_CLAUDE_DEBUG : 이 MCP 서버에서 자세한 디버그 로깅을 사용하려면 true 로 설정합니다. 기본값: false .

이러한 설정은 셸 환경이나 mcp.json 서버 구성의 env 블록 내에서 설정할 수 있습니다(단순화를 위해 mcp.json 예제의 env 블록은 제거되었지만, 필요한 경우 서버 프로세스에 설정하는 유효한 방법입니다).

기여하다

여러분의 참여를 환영합니다! 환경 설정에 대한 자세한 내용은 로컬 설치 및 개발 설정 가이드를 참조하세요.

GitHub 저장소 에 이슈와 풀 리퀘스트를 제출하세요.

특허

MIT