QQ 虚拟 MCP 服务器

MCP 磁共振 试跑者 与LLM-优化测试输出,日志捕获,逐行覆盖分析.

目录

• LLMS和测试的问题
• 关键特性
• QQ 快速启动
• 所需经费
• QQ 工具
• 多存储器支持
• 克劳德 代码虎克
• LLM 指令
• QQ 配置
• QQ 开发模式和调试
• * 解决问题
• 许可证

LLM和测试的问题

• 噪音测试输出 - Raw Vitest的输出可以极其动词性地用无用的信息来吞噬信使/信使.
• 全测试套件运行 - LLMS有时会忘记限制测试运行的范围,导致完全测试套件运行被执行.
• 掩埋控制台日志 - 控制台日志可以隐藏在测试输出中,这使得LLMS调试测试失败效率低下.
• 原始覆盖文件 - 原始覆盖文件太大 AI无法分析.
• 监视模式 - 当vitest在监视模式下运行时 LLMs就会被卡住.

关键特征

• 智能测试结果 有适应性,结构化的输出来限制噪音.
• 控制台日志抓取 防止日志在测试输出中丢失.
• 覆盖范围分析 与逐行差距的见解.
• 多仓库支助 在单个会话中进行上下文切换.
• 警卫 防止完整的工程运行,监视模式,无效的vitest命令,以及上下文跳动.

QQ 快速启动QQ

Vitest MCP服务器可以与任何MCP相容的IDE或工具一起使用,并且与所有的Javascription或Typescript Vitest一起工作. 基本配置为:

{
  "mcpServers": {
    "vitest": {
      "command": "npx",
      "args": ["-y", "@djankies/vitest-mcp"]
    }
  }
}

⚠️ 说明:以上例子可能不对所有MCP客户有效. 检查您的客户端的具体设置指令 .

QQ 客户端特定设置

从下面的设置指南中选择您首选的 IDE 或工具 :

# Add server with interactive prompts
claude mcp add vitest -- npx -y @djankies/vitest-mcp

# Add to project scope (shareable with team)
claude mcp add --scope project vitest -- npx -y @djankies/vitest-mcp

{
  "mcpServers": {
    "vitest": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@djankies/vitest-mcp"],
      "env": {}
    }
  }
}

{
  "mcpServers": {
    "vitest": {
      "command": "npx",
      "args": ["-y", "@djankies/vitest-mcp"]
    }
  }
}

{
  "mcpServers": {
    "vitest": {
      "command": "npx",
      "args": ["-y", "@djankies/vitest-mcp"],
      "type": "stdio"
    }
  }
}

{
  "mcpServers": {
    "vitest": {
      "command": "npx",
      "args": ["-y", "@djankies/vitest-mcp"]
    }
  }
}

{
  "mcpServers": {
    "vitest": {
      "command": "npx",
      "args": ["-y", "@djankies/vitest-mcp"]
    }
  }
}

{
  "mcpServers": {
    "vitest": {
      "command": "npx",
      "args": ["-y", "@djankies/vitest-mcp"]
    }
  }
}

3 使用该词

配置后, 您可以使用自然语言与测试交互 :

• "运行这个部件的测试"
• 调试此测试文件
• "分析这个文件的覆盖范围"

或预留您的信息 vitest-mcp: 确保使用这些工具:

• "最高级的mcp:运行测试这个组件"
• "vitest-mcp:调试此测试文件"
• "vitest-mcp:分析这个文件的覆盖度"

所需经费

• 节点.js联合国
• 维特: 3.x, 4.x 或 5.x 在您的项目中安装 QQ(每个主项目在CI中对照真实项目进行测试)
• 覆盖范围数字 : @vitest/coverage-v8 或者说 @vitest/coverage-istanbul,与"Vitest"(覆盖分析)相同的主要版本

npm install --save-dev vitest @vitest/coverage-v8

服务器总是运行 您的项目本身的维特 (从 node_modules,包括吊起的单雷波安装). 它从不下载Vitest,也不通过外壳运行命令.

QQ 工具

set_project_root

🚨 所需第一个 - 为所有操作设置项目根.

list_tests

在您的工程中列出测试文件 。 帮助LLMs在进行测试的同时避免滑回使用命令行工具.

run_tests

执行带有结构化输出的测试.

参数:

analyze_coverage

分析测试覆盖面,并找出差距.

说明: 覆盖阈值应在您的 vitest.config.ts 文件,不通过 MCP 参数.

该工具运行每个导入目标的测试( E)vitest related),无论你的测试住在哪里(./test, (中文(简体) ), __tests__,在源旁边.),并报告只覆盖目标,包括没有被测试触及的文件. 报告被写入一个临时目录,所以您自己 coverage/ 输出被单独处理。 测试公用事业、模拟、故事和e2e文件自动排除在外.

多存储器支持

// Project A
set_project_root({ path: "/path/to/frontend" })
run_tests({ target: "./src" })

// Project B
set_project_root({ path: "/path/to/backend" })
run_tests({ target: "./src" })

克劳德 代码虎克

自动将 Vitest 命令重定向到 MCP 工具 :

# Run from project root
curl -o .claude/vitest-hook.sh https://raw.githubusercontent.com/djankies/vitest-mcp/refs/heads/main/.claude/vitest-hook.sh
chmod +x .claude/vitest-hook.sh

那就加进你的项目 .claude/settings.local.json数字 :

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [{ "type": "command", "command": ".claude/vitest-hook.sh" }]
    }]
  }
}

钩子可以绕过 BYPASS_VITEST_HOOK 环境变量 :

BYPASS_VITEST_HOOK=1 npm test

或导出整个会话 :

export BYPASS_VITEST_HOOK=1

LLM 指令

鼓励Claude或你的ide正确使用这些工具: CLAUDE.例.md

QQ 配置

Vitest 配置优先级

如果你的项目 vitest.mcp.config.* 文件( 编号.ts, (中文(简体) ), .mts, (中文(简体) ), .cts, (中文(简体) ), .js, (中文(简体) ), .mjs 或者说 .cjs),MCP服务器以 --config否则Vitest会发现你的正常 vitest.config.* 编号 : vite.config.* 和往常一样.

这使得您可以有一个专用的 MCP 配置,不会干扰您的常规开发工作流程:

// vitest.mcp.config.ts
import { defineConfig, mergeConfig } from 'vitest/config';
import baseConfig from './vitest.config';

export default mergeConfig(baseConfig, defineConfig({
  test: {
    // MCP-specific settings, e.g. a longer timeout for AI-driven runs
    testTimeout: 30000,
  },
}));

记者,覆盖输出和控制台抓取由服务器设置在命令行上,因此不需要配置.

覆盖率阈值

实现在 analyze_coverage 工具,只需在虚拟配置文件中配置:

// vitest.config.ts or vitest.mcp.config.ts
import { defineConfig } from 'vitest/config';

export default defineConfig({
  test: {
    coverage: {
      provider: 'v8',
      reporter: ['text', 'json', 'html'],
      thresholds: {
        lines: 90,
        functions: 85,
        branches: 80,
        statements: 90
      }
    }
  }
});

💡 说明:无论门槛设置如何,总有覆盖面分析。 阈值报告只是帮助 你的LLM目标.

Vitest-MCP 配置文件

可选 .vitest-mcp.json 在家庭或项目目录中:

{
  "safety": {
    "allowedPaths": ["/Users/username/Projects"]
  },
  "testDefaults": {
    "format": "detailed",
    "timeout": 60000
  }
}

优先权顺序

配置按以下顺序合并(最优先优先第一):

1. 命令行旗帜
2. 环境变量
3. 配置文件
4. 内建默认

QQ 开发模式和调试

启用调试模式

设置详细记录的调试环境变量 :

VITEST_MCP_DEBUG=true

或者在您的 MCP 配置文件中 :

{
  "mcpServers": {
    "vitest": {
      "command": "npx",
      "args": ["-y", "@djankies/vitest-mcp"],
      "env": {
        "VITEST_MCP_DEBUG": "true"
      }
    }
  }
}

发展模式

启用在自己的密码库测试服务器 :

# Set in .env.development, or in your mcp config file 
VITEST_MCP_DEV_MODE=true

* 解决问题

"没有找到" - 在您设置为根的工程中安装: npm install --save-dev vitest

"没有找到封面供应商" 编号 : "和维特不匹配" - 安装匹配您 Vitest 主修的提供者, 例如 . npm install --save-dev @vitest/coverage-v8@4 维特4号

钩子问题 - 绕道: BYPASS_VITEST_HOOK=1 npm test

找到窃听器了吗? 请提交错误报告,谢谢.

许可证

麻省理工学院——见 自由主义。 。 。 .