코드로직-mcp-서버
AI 프로그래밍 어시스턴트에서 Codelogic의 풍부한 소프트웨어 종속성 데이터를 활용할 수 있는 MCP 서버입니다 .
구성 요소
도구
서버는 두 가지 도구를 구현합니다.
- codelogic-method-impact : CodeLogic 서버의 API에서 코드에 대한 영향 평가를 가져옵니다.
- 작업 중인 주어진 "메서드"와 연관된 "클래스"를 가져옵니다.
- codelogic-database-impact : 코드와 데이터베이스 엔터티 간의 영향을 분석합니다.
- 데이터베이스 엔터티 유형(열, 테이블 또는 뷰)과 해당 이름을 가져옵니다.
설치하다
전제 조건
MCP 서버는 Astral UV를 사용하여 실행되므로 설치 하십시오.
다양한 IDE에 대한 구성
Visual Studio Code 구성
VS Code에서 이 MCP 서버를 구성하려면:
- 먼저, VS Code에서 GitHub Copilot 에이전트 모드가 활성화되어 있는지 확인하세요.
- 다음 구성으로 작업 공간에
.vscode/mcp.json 파일을 만듭니다.
지엑스피1
참고: 일부 시스템에서는 "uvx" 대신 uvx 실행 파일의 전체 경로를 사용해야 할 수 있습니다. 예: Linux/Mac에서는 /home/user/.local/bin/uvx , Windows에서는 C:\Users\username\AppData\Local\astral\uvx.exe
- 또는 명령 팔레트에서
MCP: Add Server 명령을 실행하고 서버 정보를 제공할 수 있습니다. - MCP 서버를 관리하려면 명령 팔레트에서
MCP: List Servers 명령을 사용하세요. - 구성이 완료되면 서버 도구를 Copilot 에이전트 모드에서 사용할 수 있습니다. 에이전트 모드에서 채팅 보기의 도구 버튼을 클릭하여 필요에 따라 특정 도구를 켜거나 끌 수 있습니다.
- 에이전트 모드에서 Codelogic 도구를 사용하려면 코드 영향이나 데이터베이스 관계에 대해 구체적으로 질문하면 에이전트가 적절한 도구를 활용합니다.
클로드 데스크톱 구성
구성 파일을 편집하여 Claude Desktop을 구성합니다.
- MacOS의 경우:
~/Library/Application\ Support/Claude/claude_desktop_config.json - Windows의 경우:
%APPDATA%/Claude/claude_desktop_config.json - Linux의 경우:
~/.config/Claude/claude_desktop_config.json
구성 파일에 다음을 추가하세요.
"mcpServers": {
"codelogic-mcp-server": {
"command": "uvx",
"args": [
"codelogic-mcp-server@latest"
],
"env": {
"CODELOGIC_SERVER_HOST": "<url to the server e.g. https://myco.app.codelogic.com>",
"CODELOGIC_USERNAME": "<my username>",
"CODELOGIC_PASSWORD": "<my password>",
"CODELOGIC_WORKSPACE_NAME": "<my workspace>"
}
}
}
참고: 일부 시스템에서는 "uvx" 대신 uvx 실행 파일의 전체 경로를 사용해야 할 수 있습니다. 예: Linux/Mac에서는 /home/user/.local/bin/uvx , Windows에서는 C:\Users\username\AppData\Local\astral\uvx.exe
구성을 추가한 후 Claude Desktop을 다시 시작하여 변경 사항을 적용합니다.
Windsurf IDE 구성
Windsurf IDE 로 이 MCP 서버를 실행하려면:
Windsurf IDE 구성 :
Windsurf IDE를 구성하려면 ~/.codeium/windsurf/mcp_config.json 구성 파일을 만들거나 수정해야 합니다.
다음 구성을 파일에 추가하세요.
"mcpServers": {
"codelogic-mcp-server": {
"command": "uvx",
"args": [
"codelogic-mcp-server@latest"
],
"env": {
"CODELOGIC_SERVER_HOST": "<url to the server e.g. https://myco.app.codelogic.com>",
"CODELOGIC_USERNAME": "<my username>",
"CODELOGIC_PASSWORD": "<my password>",
"CODELOGIC_WORKSPACE_NAME": "<my workspace>"
}
}
}
참고: 일부 시스템에서는 "uvx" 대신 uvx 실행 파일의 전체 경로를 사용해야 할 수 있습니다. 예: Linux/Mac에서는 /home/user/.local/bin/uvx , Windows에서는 C:\Users\username\AppData\Local\astral\uvx.exe
구성을 추가한 후 Windsurf IDE를 다시 시작하거나 도구를 새로 고쳐 변경 사항을 적용합니다.
커서 구성
Cursor에서 CodeLogic MCP 서버를 구성하려면:
.cursor/mcp.json 파일을 만들어 MCP 서버를 구성합니다.
{
"mcpServers": {
"codelogic-mcp-server": {
"command": "uvx",
"args": [
"codelogic-mcp-server@latest"
],
"env": {
"CODELOGIC_SERVER_HOST": "<url to the server e.g. https://myco.app.codelogic.com>",
"CODELOGIC_USERNAME": "<my username>",
"CODELOGIC_PASSWORD": "<my password>",
"CODELOGIC_WORKSPACE_NAME": "<my workspace>",
"CODELOGIC_DEBUG_MODE": "true"
}
}
}
}
참고: 일부 시스템에서는 "uvx" 대신 uvx 실행 파일의 전체 경로를 사용해야 할 수 있습니다. 예: Linux/Mac에서는 /home/user/.local/bin/uvx , Windows에서는 C:\Users\username\AppData\Local\astral\uvx.exe
- 변경 사항을 적용하려면 커서를 다시 시작하세요.
이제 CodeLogic MCP 서버 도구를 Cursor 작업 공간에서 사용할 수 있습니다.
AI 보조 지침/규칙
AI 비서가 CodeLogic 도구를 효과적으로 사용할 수 있도록 다음 지침/규칙을 클라이언트 구성에 추가할 수 있습니다. 팀의 특정 코딩 표준, 모범 사례 및 워크플로 요구 사항에 맞게 이러한 지침을 사용자 지정하는 것이 좋습니다.
VS Code(GitHub Copilot) 지침
다음 내용으로 .vscode/copilot-instructions.md 파일을 만듭니다.
# CodeLogic MCP Server Instructions
When modifying existing code methods:
- Use codelogic-method-impact to analyze code changes
- Use codelogic-database-impact for database modifications
- Highlight impact results for the modified methods
When modifying SQL code or database entities:
- Always use codelogic-database-impact to analyze potential impacts
- Highlight impact results for the modified database entities
To use the CodeLogic tools effectively:
- For code impacts: Ask about specific methods or functions
- For database relationships: Ask about tables, views, or columns
- Review the impact results before making changes
- Consider both direct and indirect impacts
클로드 데스크탑 지침
다음 내용으로 ~/.claude/instructions.md 파일을 만듭니다.
# CodeLogic MCP Server Instructions
When modifying existing code methods:
- Use codelogic-method-impact to analyze code changes
- Use codelogic-database-impact for database modifications
- Highlight impact results for the modified methods
When modifying SQL code or database entities:
- Always use codelogic-database-impact to analyze potential impacts
- Highlight impact results for the modified database entities
To use the CodeLogic tools effectively:
- For code impacts: Ask about specific methods or functions
- For database relationships: Ask about tables, views, or columns
- Review the impact results before making changes
- Consider both direct and indirect impacts
윈드서프 IDE 규칙
다음 내용으로 ~/.codeium/windsurf/memories/global_rules.md 마크다운 파일을 만들거나 수정하세요.
When modifying existing code methods:
- Use codelogic-method-impact to analyze code changes
- Use codelogic-database-impact for database modifications
- Highlight impact results for the modified methods
When modifying SQL code or database entities:
- Always use codelogic-database-impact to analyze potential impacts
- Highlight impact results for the modified database entities
To use the CodeLogic tools effectively:
- For code impacts: Ask about specific methods or functions
- For database relationships: Ask about tables, views, or columns
- Review the impact results before making changes
- Consider both direct and indirect impacts
커서 글로벌 규칙
Cursor에서 CodeLogic 규칙을 구성하려면:
- 커서 설정 열기
- "규칙" 섹션으로 이동하세요
- "사용자 규칙"에 다음 내용을 추가합니다.
# CodeLogic MCP Server Rules
## Codebase
- The CodeLogic MCP Server is for java, javascript, typescript, and C# dotnet codebases
- don't run the tools on python or other non supported codebases
## AI Assistant Behavior
- When modifying existing code methods:
- Use codelogic-method-impact to analyze code changes
- Use codelogic-database-impact for database modifications
- Highlight impact results for the modified methods
- When modifying SQL code or database entities:
- Always use codelogic-database-impact to analyze potential impacts
- Highlight impact results for the modified database entities
- To use the CodeLogic tools effectively:
- For code impacts: Ask about specific methods or functions
- For database relationships: Ask about tables, views, or columns
- Review the impact results before making changes
- Consider both direct and indirect impacts
환경 변수
다음 환경 변수를 구성하여 서버의 동작을 사용자 지정할 수 있습니다.
CODELOGIC_SERVER_HOST : CodeLogic 서버의 URL입니다.CODELOGIC_USERNAME : CodeLogic 사용자 이름입니다.CODELOGIC_PASSWORD : CodeLogic 비밀번호입니다.CODELOGIC_WORKSPACE_NAME : 사용할 작업 공간의 이름입니다.CODELOGIC_DEBUG_MODE : 디버그 모드를 활성화하려면 true 로 설정합니다. 활성화하면 timing_log.txt 및 impact_data*.json 과 같은 추가 디버그 파일이 생성됩니다. 기본값은 false 입니다.
구성 예
"env": {
"CODELOGIC_SERVER_HOST": "<url to the server e.g. https://myco.app.codelogic.com>",
"CODELOGIC_USERNAME": "<my username>",
"CODELOGIC_PASSWORD": "<my password>",
"CODELOGIC_WORKSPACE_NAME": "<my workspace>",
"CODELOGIC_DEBUG_MODE": "true"
}
버전 고정
서버의 최신 버전을 사용하는 대신 pypi 의 버전과 일치하도록 args 필드를 변경하여 특정 버전으로 고정할 수 있습니다.
"args": [
"codelogic-mcp-server@0.2.2"
],
버전 호환성
이 MCP 서버에는 다음과 같은 버전 호환성 요구 사항이 있습니다.
- 버전 0.3.1 이하: 모든 CodeLogic API 버전과 호환
- 버전 0.4.0 이상: CodeLogic API 버전 25.10.0 이상이 필요합니다.
업그레이드하는 경우 CodeLogic 서버가 최소 API 버전 요구 사항을 충족하는지 확인하세요.
테스트
단위 테스트 실행
이 프로젝트는 테스트를 위해 unittest를 사용합니다. 외부 종속성 없이 단위 테스트를 실행할 수 있습니다.
python -m unittest discover -s test -p "unit_*.py"
단위 테스트는 모의 데이터를 사용하며 CodeLogic 서버에 연결할 필요가 없습니다.
통합 테스트(선택 사항)
실제 CodeLogic 서버에 연결하는 통합 테스트를 실행하려면 다음을 수행하세요.
test/.env.test.example``test/.env.test 로 복사하고 CodeLogic 서버 세부 정보로 채웁니다.- 통합 테스트를 실행합니다.
python -m unittest discover -s test -p "integration_*.py"
참고: 통합 테스트를 수행하려면 CodeLogic 서버 인스턴스에 액세스해야 합니다.