Codelogicincengineering Codelogic MCP Server

🚀 codelogic-mcp-server

codelogic-mcp-server 是一個利用 Codelogic 豐富軟件依賴數據的 MCP 服務器，可用於您的 AI 編程助手，為編程工作提供有力支持。

🚀 快速開始

本服務器主要用於為 AI 編程助手提供支持，藉助 Codelogic 的軟件依賴數據，幫助您更好地完成編程任務。

✨ 主要特性

工具

該服務器實現了一個實用工具：

• get-impact：從 codelogic 服務器 API 拉取代碼的影響評估。此工具接受給定的“方法”（method）及其關聯的“類”（class），方便您對代碼進行評估和分析。

📦 安裝指南

先決條件

MCP 服務器依賴於 Astral UV 運行，請先安裝。

Claude Desktop

• MacOS：配置文件路徑為 ~/Library/Application\ 支持/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，例如https://myco.app.codelogic.com>",
      "CODELOGIC_USERNAME": "<我的用戶名>",
      "CODELOGIC_PASSWORD": "<我的密碼>",
      "CODELOGIC_MV_NAME": "<我的 matérialized視圖>"
    }
  }
}

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，例如https://myco.app.codelogic.com>",
      "CODELOGIC_USERNAME": "<我的用戶名>",
      "CODELOGIC_PASSWORD": "<我的密碼>",
      "CODELOGIC_MV_NAME": "<我的 matérialized視圖>"
    }
  }
}

添加全局規則

創建或修改 ~/.codeium/windsurf/memories/global_rules.md Markdown 文件，並添加以下內容：

當我要求你修改現有代碼時，請嘗試運行 get-impact MCP 工具針對提供的代碼以及任何正在更改的方法或函數。確保從工具返回的結果突出顯示給定方法或函數的影響。

添加配置後，重啟 Windsurf IDE 或刷新工具以應用更改。

版本固定

若不想使用 MCP 服務器的最新版本，可以通過將args 字段更改為對應於 pypi 中的特定版本來固定版本，例如：

    "args": [
      "codelogic-mcp-server@0.2.2"
    ],

💻 使用示例

基礎用法

本項目主要通過配置文件進行使用，以下是在不同環境下的配置示例：

Claude Desktop 配置示例

"mcpServers": {
  "codelogic-mcp-server": {
    "command": "uvx",
    "args": [
      "codelogic-mcp-server@latest"
    ],
    "env": {
      "CODELOGIC_SERVER_HOST": "<服務器URL，例如https://myco.app.codelogic.com>",
      "CODELOGIC_USERNAME": "<我的用戶名>",
      "CODELOGIC_PASSWORD": "<我的密碼>",
      "CODELOGIC_MV_NAME": "<我的 matérialized視圖>"
    }
  }
}

Windsurf IDE 配置示例

"mcpServers": {
  "codelogic-mcp-server": {
    "command": "uvx",
    "args": [
      "codelogic-mcp-server@latest"
    ],
    "env": {
      "CODELOGIC_SERVER_HOST": "<服務器URL，例如https://myco.app.codelogic.com>",
      "CODELOGIC_USERNAME": "<我的用戶名>",
      "CODELOGIC_PASSWORD": "<我的密碼>",
      "CODELOGIC_MV_NAME": "<我的 matérialized視圖>"
    }
  }
}

🔧 技術細節

測試

運行單元測試

項目使用 unittest 進行測試，無需任何外部依賴即可運行單元測試，命令如下：

python -m unittest discover -s test -p "unit_*.py"

單元測試使用 mock 數據，不需要連接到 CodeLogic 服務器。

集成測試（可選）

若想運行連接到實際 CodeLogic 服務器的集成測試，可按以下步驟操作：

1. 安裝 requests 包：

   pip install requests
   

2. 在終端中運行以下命令：

   python -m unittest discover -s test -p "integration_*.py" --verbose
   

這些測試會連接到實際的 CodeLogic 服務器，並需要有效的憑據。請確保您已設置 CODELOGIC_SERVER_HOST、CODELOGIC_USERNAME 和 CODELOGIC_PASSWORD 環境變量。