코드로직-mcp-서버

AI 프로그래밍 어시스턴트에서 Codelogic의 풍부한 소프트웨어 종속성 데이터를 활용할 수 있는 MCP 서버입니다 .

구성 요소

도구

서버는 두 가지 도구를 구현합니다.

codelogic-method-impact : CodeLogic 서버의 API에서 코드에 대한 영향 평가를 가져옵니다.
- 작업 중인 주어진 "메서드"와 연관된 "클래스"를 가져옵니다.
codelogic-database-impact : 코드와 데이터베이스 엔터티 간의 영향을 분석합니다.
- 데이터베이스 엔터티 유형(열, 테이블 또는 뷰)과 해당 이름을 가져옵니다.

설치하다

전제 조건

MCP 서버는 Astral UV를 사용하여 실행되므로 설치 하십시오.

VS Code에서 이 MCP 서버를 구성하려면:

먼저, VS Code에서 GitHub Copilot 에이전트 모드가 활성화되어 있는지 확인하세요.
다음 구성으로 작업 공간에 .vscode/mcp.json 파일을 만듭니다.

지엑스피1

또는 명령 팔레트에서 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_MV_NAME": "<my materialized view>"
    }
  }
}

구성을 추가한 후 Claude Desktop을 다시 시작하여 변경 사항을 적용합니다.

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_MV_NAME": "<my materialized view>"
    }
  }
}

구성을 추가한 후 Windsurf IDE를 다시 시작하거나 도구를 새로 고쳐 변경 사항을 적용합니다.

Cursor에서 CodeLogic MCP 서버를 구성하려면:

.cursor/mcp.json 파일을 만들어 MCP 서버를 구성합니다.

{
  "servers": {
    "codelogic-mcp-server": {
      "type": "stdio",
      "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_MV_NAME": "<my materialized view>",
        "CODELOGIC_DEBUG_MODE": "true"
      }
    }
  }
}

변경 사항을 적용하려면 커서를 다시 시작하세요.

이제 CodeLogic MCP 서버 도구를 Cursor 작업 공간에서 사용할 수 있습니다.

AI 보조 지침

AI 어시스턴트가 CodeLogic 도구를 효과적으로 사용할 수 있도록 클라이언트 구성에 다음 지침을 추가할 수 있습니다.

다음 내용으로 .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

다음 내용으로 ~/.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/rules/codelogic-rules.md 파일을 만듭니다.

# CodeLogic MCP Server Rules

## 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_MV_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_MV_NAME": "<my materialized view>",
  "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 서버 인스턴스에 액세스해야 합니다.

CodeLogic

Integrations