项目简介

DevAC MCP Server（'@pietgk/devac-mcp'）是 DevAC（vivief）代码分析平台的一部分。它可以将本地代码库（支持 TypeScript、Python、C#）的分析结果（如函数、类、依赖关系）转化为一个可查询的“代码知识图谱”，并通过标准的 Model Context Protocol (MCP) 协议暴露给 AI 助手（如 Claude Desktop、Cursor）。AI 助手可以像查询数据库一样，实时、安全地探索你的代码库结构，理解函数调用关系，或者查找受代码变更影响的文件。

主要功能

AI 助手可以通过此服务器获得以下能力：

智能搜索：按名称或类型查找代码中的符号（函数、类、变量等）。
依赖分析：查看一个函数被谁调用（调用者）或调用了谁（被调用者）。
影响分析：指定一些修改过的文件，找出所有可能受影响的文件。
文件概览：查看某个文件里定义的所有符号。
自定义查询：使用 SQL 语句直接查询底层的代码图谱数据（只读模式）。

安装步骤

前置条件：确保你的系统已安装 Node.js (20+) 和 pnpm (9+)。

获取代码：克隆仓库并安装依赖。

git clone https://github.com/pietgk/vivief.git
cd vivief
pnpm install
pnpm build

全局安装（可选）：将 CLI 工具链接到全局，方便在任何地方使用 'devac' 命令。

pnpm --filter @pietgk/devac-cli link --global

服务器配置 (MCP客户端配置)

在您的 AI 助手（如 Claude Desktop）的 MCP 配置文件中，添加以下服务器配置。这将告诉 AI 助手如何启动并连接到这个代码分析服务器。

{
  "mcpServers": {
    "devac-code-analysis": {
      "command": "npx",
      "args": [
        "-y",
        "@pietgk/devac-mcp",
        "-p",
        "/ABSOLUTE/PATH/TO/YOUR/CODE/PROJECT"
      ]
    }
  }
}

配置参数说明：

'command': 启动命令。这里使用 'npx' 来直接运行 '@pietgk/devac-mcp' 包。
'args': 启动参数。
- '-y': 允许 'npx' 在需要时自动下载包。
- '@pietgk/devac-mcp': 要运行的 MCP 服务器包名。
- '-p': 指定要分析的代码项目根目录的绝对路径。请将 '/ABSOLUTE/PATH/TO/YOUR/CODE/PROJECT' 替换成你实际项目的路径。

基本使用方法

准备代码库：确保你的项目已经被 DevAC 分析过，生成了分析数据（通常位于项目根目录的 '.devac' 文件夹内）。如果没有，可以先在项目根目录运行 'devac analyze' 命令。
启动 MCP 服务器：根据上面的配置，当您启动 AI 助手时，它会自动运行此命令并连接服务器。您也可以手动在终端测试：'npx -y @pietgk/devac-mcp -p /your/project/path'。
在 AI 助手中使用：连接成功后，您就可以在 AI 助手的对话中，直接要求它分析代码了。例如：
- “查找项目中所有名为 'UserService' 的类。”
- “'src/utils/logger.ts' 这个文件里有哪些函数？”
- “如果我修改了 'src/api/auth.ts'，哪些文件会受到影响？”
- “'calculateTotal' 这个函数被哪些其他函数调用？”

关键词

项目简介

主要功能

安装步骤

服务器配置 (MCP客户端配置)

基本使用方法

信息