Integrations
Enhances GitHub Copilot in VS Code with CodeAlive's deep code understanding, allowing it to leverage semantic search and project-wide context for improved code suggestions.
Supports direct invocation via Python interpreter as an alternative configuration option for running the MCP server with AI clients.
CodeAlive MCP: 프로젝트에 대한 심층적 컨텍스트(특히 대규모 코드베이스의 경우)
CodeAlive API 용 MCP(Model Context Protocol) 서버를 사용하면 Claude Desktop, Cursor, Windserf, VS Code(GitHub Copilot), Cline, Roo-Code, Refact와 같은 AI 클라이언트가 CodeAlive의 고급 의미 코드 검색 및 코드베이스 상호 작용 기능에 액세스할 수 있습니다.
CodeAlive MCP는 프로젝트 코드베이스에서 풍부한 컨텍스트를 제공하여 이러한 에이전트를 강화하고, 보다 지능적이고 효율적인 상호작용을 가능하게 합니다.
CodeAlive란 무엇인가요?
CodeAlive는 문서와 종속성을 포함한 전체 코드베이스를 분석하여 구조, 패턴, 로직을 파악하는 플랫폼입니다. 저장소 또는 작업 공간에 대한 상세한 내부 맵을 생성하여 모든 IT 전문가에게 솔루션 관련 질문에 빠르고 안정적이며 고품질의 답변을 제공합니다.
이 MCP 서버를 사용하면 AI 에이전트(예: Claude, Copilot 등)가 CodeAlive의 심층적인 코드 이해 능력을 활용할 수 있습니다. 이를 통해 에이전트는 다음과 같은 이점을 얻을 수 있습니다.
- 관련 코드를 더 빠르게 찾으세요. 질문과 관련된 정확한 코드 조각을 받으세요.
- 더 큰 그림을 이해하세요: 분리된 파일만이 아니라 전체 저장소나 작업 공간에 대한 맥락을 파악하세요.
- 비용과 시간 절감: 정확한 맥락을 직접 제공하여 에이전트의 효율성을 높이고, 광범위한 파일 검색이나 추측의 필요성을 줄입니다.
목차
사용 가능한 도구
MCP 서버는 다음과 같은 도구를 제공합니다.
chat_completions
: 코드베이스 컨텍스트를 사용하여 CodeAlive 채팅 API에 접근합니다. API 키가 단 하나의 데이터 소스에만 할당된 경우, 데이터 소스 지정은 선택 사항입니다.get_data_sources
: CodeAlive에서 인덱싱한 사용 가능한 저장소와 작업 공간을 나열합니다.search_code
: CodeAlive의 시맨틱 검색을 사용하여 데이터 소스 전체에서 코드 조각을 검색합니다. API 키가 단 하나의 데이터 소스에만 할당된 경우, 해당 데이터 소스를 지정하는 것은 선택 사항입니다.
시작하기
필수 조건
- 파이썬 3.11
- uv (권장) 또는 pip
- CodeAlive 계정 및 API 키
API 키 받기
- https://app.codealive.dev/ 에서 CodeAlive 계정에 로그인하세요.
- API 키 섹션(조직 아래)으로 이동합니다.
- " + API 키 만들기 "를 클릭하세요.
- 키에 설명적인 이름을 지정합니다(예: "내 로컬 MCP 키"). 그리고 적절한 범위를 선택합니다(예: "모든 데이터 소스" 또는 특정 데이터 소스 선택).
- " 만들기 "를 클릭하세요.
- 중요: 생성된 API 키를 즉시 복사하여 안전하게 보관하세요. 대화 상자를 닫으면 다시 볼 수 없습니다.
설치
uv로 설치하기 (권장)
지엑스피1
pip로 설치하기
구성
환경 변수나 명령줄 인수를 사용하여 서버를 구성합니다.
환경 변수
지원되는 환경 변수는 다음과 같습니다.
CODEALIVE_API_KEY
: CodeAlive API 키입니다. (--api-key
로 전달하지 않는 한 필수입니다.)
명령줄 옵션
--api-key
: CodeAlive API 키입니다.CODEALIVE_API_KEY
환경 변수를 재정의합니다.--transport
: 전송 유형:"stdio"
(기본값) 또는"sse"
.--host
: SSE 전송을 위한 호스트 주소(기본값:0.0.0.0
).--port
: SSE 전송을 위한 포트(기본값:8000
).--debug
: 표준 출력/오류에 대한 자세한 로깅을 통해 디버그 모드를 활성화합니다.
AI 클라이언트와 통합
다음은 인기 AI 클라이언트의 구성 예시입니다. /path/to/your/codealive-mcp
및 YOUR_API_KEY_HERE
와 같은 자리 표시자를 실제 값으로 바꿔야 합니다. 일반적으로 API 키를 구성 파일에 직접 입력하는 것보다 환경 변수( env
블록)를 사용하는 것이 좋습니다.
계속하다
- 프로젝트의
.continue/config.yaml
또는~/.continue/config.yaml
에서 전역적으로 MCP 서버를 구성합니다.Copy - 다시 시작 계속하거나 구성을 다시 로드합니다.
클로드 데스크탑
- Claude Desktop 구성 파일을 편집하세요.
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
(일반적으로C:\Users\YourUsername\AppData\Roaming\Claude\claude_desktop_config.json
)
- macOS:
- MCP 서버 구성을 추가합니다.(파일에 이미 내용이 있는 경우 이것이 올바르게 병합되는지 확인하세요)Copy
- Claude Desktop을 완전히 다시 시작합니다.
GitHub Copilot을 사용한 Visual Studio Code
- 명령 팔레트(
Ctrl+Shift+P
또는Cmd+Shift+P
)를 사용하여 VS Code 설정(JSON)을 열고 "기본 설정: 사용자 설정 열기(JSON)"를 선택합니다. settings.json
에 MCP 서버 구성을 추가합니다.(이것이 기존 설정과 올바르게 병합되는지 확인하세요)Copy- VS Code를 다시 시작합니다. GitHub Copilot 확장 프로그램이 버전/설정에 따라 필요한 경우 MCP 서버를 사용할 수 있도록 구성되어 있는지 확인합니다.
커서
- 커서 설정을 엽니다(
Cmd+,
또는Ctrl+,
). - 왼쪽 패널의 "MCP" 섹션으로 이동합니다.
- "새로운 글로벌 MCP 서버 추가"를 클릭합니다.
- 다음 JSON 구성을 입력하고 경로와 API 키를 업데이트하세요.Copy
- 구성을 저장합니다.
- 커서를 완전히 다시 시작합니다.
Python을 직접 사용하기
uv
사용하지 않으려면 가상 환경에서 Python 인터프리터를 사용하여 서버 스크립트를 직접 호출할 수 있습니다. 클라이언트 설정에서 command
와 args
적절히 수정하세요.
Python을 사용한 Claude Desktop
파이썬을 사용한 커서
문제 해결
MCP 서버가 AI 클라이언트와 제대로 작동하지 않는 경우 다음 단계를 따르세요.
- 디버그 로깅 활성화: 클라이언트 MCP 구성의
args
에--debug
플래그를 추가하세요. 이렇게 하면 MCP 서버 자체의 자세한 로그가 표준 출력/오류 스트림으로 출력됩니다. 이 스트림의 출력 위치는 클라이언트가 MCP 프로세스를 관리하는 방식에 따라 달라집니다. - MCP 서버 출력 확인:
- 터미널에서 직접 서버 명령을 실행해보세요(먼저 가상 환경을 활성화하세요):Copy
- 특히 API 키 검증이나 연결 문제와 관련된 오류 메시지를 찾아보세요.
- 터미널에서 직접 서버 명령을 실행해보세요(먼저 가상 환경을 활성화하세요):
- 클라이언트 로그 확인: 해당 AI 클라이언트의 설명서나 설정을 참조하여 로그 파일을 확인하세요. "codealive" MCP 서버 시작 또는 통신 관련 오류를 확인하세요.
- 클로드 데스크탑:
- 주요 애플리케이션 로그를 확인하세요.
- MCP 관련 로그를 찾아보세요.
- macOS:
~/Library/Logs/Claude/mcp.log
및~/Library/Logs/Claude/mcp-server-codealive.log
- Windows:
%LOCALAPPDATA%\Claude\Logs\mcp.log
및%LOCALAPPDATA%\Claude\Logs\mcp-server-codealive.log
(경로는 일반적으로C:\Users\YourUsername\AppData\Local\Claude\Logs
입니다)
- macOS:
- 커서:
- 명령 팔레트(
Cmd+Shift+P
/Ctrl+Shift+P
) ->Developer: Toggle Developer Tools
. - 출력 패널을 확인하세요.
View
->Output
으로 이동하거나 하단 패널에서Output
클릭하세요. 출력 패널 오른쪽의 드롭다운 메뉴에서CodeAlive
,MCP
또는 서버 프로세스와 관련된 채널을 찾으세요.--debug
활성화된 경우, 이 채널에는 MCP 서버의 직접 stdout/stderr이 포함되는 경우가 많습니다. - 명령 팔레트 ->
Developer: Open Logs Folder
사용하세요. 특히 주 프로세스나 확장 호스트와 관련된 파일을 확인하세요. - 로그 폴더 위치:
- macOS:
~/Library/Application Support/Cursor/logs/
- Windows:
%APPDATA%\Cursor\logs\
(일반적으로C:\Users\YourUsername\AppData\Roaming\Cursor\logs\
)
- macOS:
- 명령 팔레트(
- VS 코드(계속/조종):
- 명령 팔레트(
Cmd+Shift+P
/Ctrl+Shift+P
) ->Developer: Toggle Developer Tools
. - 출력 패널을 확인하세요.
View
->Output
으로 이동하거나 하단 패널에서Output
클릭하세요. 출력 패널 오른쪽의 드롭다운 메뉴에서CodeAlive
,MCP
,GitHub Copilot
또는Continue
라는 채널을 찾으세요. MCP 서버 로그(특히--debug
사용 시)가 여기로 라우팅될 수 있습니다. - 명령 팔레트 ->
Developer: Show Logs...
-> 드롭다운에서Extension Host
선택하세요. Copilot 또는 Continue 확장 프로그램이 MCP를 통해 통신을 시도하는 것과 관련된 오류를 확인하세요. - Continue 관련 로그의 경우: 명령 팔레트 ->
Continue: Focus on Continue Console View
(설정에서Continue: Enable Console
활성화해야 함). Continue 문제 해결 문서를 참조하세요.
- 명령 팔레트(
- 클로드 데스크탑:
- 구성 확인: 클라이언트의 MCP 구성 파일에서
command
,args
,env
경로와 값을 다시 확인하세요. JSON/YAML 구문이 올바른지 확인하세요. - API 키:
CODEALIVE_API_KEY
가 올바른지 확인하세요.
문제가 지속되면 CodeAlive MCP 서버 저장소(사용 가능한 경우)에 관련 로그와 구성 세부 정보(API 키 마스킹)를 포함하여 문제를 여는 것을 고려하세요.
추가 지원이 필요하면 support@codealive.dev 로 지원팀에 문의하세요.
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
코드베이스에 대한 심층적인 의미적 이해를 제공하여 AI 에이전트를 강화하고, 고급 코드 검색 및 상황 인식을 통해 보다 지능적인 상호 작용을 가능하게 하는 모델 컨텍스트 프로토콜 서버입니다.
Related MCP Servers
- AsecurityAlicenseAqualityAn enhanced Model Context Protocol server that enables AI assistants to interact with ClickUp workspaces, supporting task relationships, comments, checklists, and workspace management through natural language.Last updated -40203TypeScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server enabling AI agents to access and manipulate ServiceNow data through natural language interactions, allowing users to search for records, update them, and manage scripts.Last updated -9PythonMIT License
- -securityAlicense-qualityA Model Context Protocol server that enables AI agents to retrieve and understand entire codebases at once, providing tools to analyze local workspaces or remote GitHub repositories.Last updated -9TypeScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that enhances AI-generated code quality through comprehensive analysis across 10 critical dimensions, helping identify issues before they become problems.Last updated -3PythonApache 2.0