🚀 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 环境变量。