Cursor Test MCP

MCP开发工具

提供方 beycanyildiz

开发工具 未标注 无需鉴权 社区 / 第三方 Cursor

Cursor Test MCP是一个在Cursor IDE中管理和理解项目测试的模型上下文协议服务器,支持自动化测试框架检测、执行和分析。

一句话选型结论

按资料字段整理

Cursor Test MCP 属于开发工具类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Cursor,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

测试框架TypeScript本地部署测试执行覆盖率分析测试生成输出分析

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Cursor Test MCP当前 未标注 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方beycanyildiz上游标注的维护方 beycanyildiz
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.0 KB
来自项目仓库与上游目录的原文,未做删改

光标测试MCP–AI测试工程师

许可证: 麻省理工学院\
Node.js版本: >=18.0.0

一种模型上下文协议(MCP)服务器,使Cursor IDE中的AI助手能够通过自动测试框架检测、执行和分析来管理和理解项目测试。

特性

  • 框架检测:自动检测测试框架(Jest、Vitest、Mocha、pytest)
  • 测试执行:运行超时和输出截断的测试
  • 覆盖率分析:阅读和分析报道报告
  • 测试骨架生成:为不同框架生成测试文件骨架
  • 输出摘要:分析和构造测试输出以了解AI
  • 错误处理:具有详细错误消息的稳健错误处理

快速开始

安装```bash

git clone https://github.com/your-username/cursor-test-mcp.git
cd cursor-test-mcp
npm install
npm run build


或者使用安装脚本:```bash
./install.sh

手动配置

创建或编辑 ~/.cursor/mcp.json 对于全局配置:```json
{
"mcpServers": {
"cursor-test-mcp": {
"command": "node",
"args": ["/path/to/cursor-test-mcp/dist/index.js"],
"env": {
"MCP_MODE": "stdio",
"LOG_LEVEL": "info",
"PROJECT_ROOT": "/optional/project/path"
}
}
}
}


> **备注**\
> 如果您已经定义了其他MCP服务器,只需添加 `cursor-test-mcp` 进入现有 `mcpServers` 对象。

安装后:

1. 重新启动游标
1. 启用 **`cursor-test-mcp`** 在MCP设置中

## 可用工具

### 框架检测

|工具|说明|
|------|-------------|
| `test_detect_framework` |检测测试框架和默认测试命令|

### 测试执行

|工具|说明|
|------|-------------|
| `test_run` |运行测试并返回汇总结果|

### 覆盖率分析

|工具|说明|
|------|-------------|
| `test_read_coverage` |阅读覆盖率摘要并分析覆盖率最低的文件|

### 测试生成

|工具|说明|
|------|-------------|
| `test_generate_skeleton` |为给定主题生成测试文件骨架|

### 产出分析

|工具|说明|
|------|-------------|
| `test_summarize_output` |解析和构造原始测试输出|

## 工具详细信息

### `test_detect_framework`

检测当前项目中最可能的测试框架和默认测试命令。

**输入:**```json
{
"projectPath": "string (optional, absolute path)"
}

行为:

  • 如果 projectPath 未提供:
  • 第一次检查 PROJECT_ROOT 环境变量
  • 回落到 process.cwd() (当前工作目录)
  • 分析 package.json、锁定文件和pytest配置文件
  • 检测Jest/Vitest/Mocha/pytest或通用 npm test

示例提示:

  • “检测测试框架,并向我显示此项目的默认测试命令。”
  • “这个项目使用什么测试框架,命令是什么?”

test_run

运行项目的测试并返回汇总结果。

输入:```json
{
"projectPath": "string (optional, absolute path)",
"command": "string (optional, e.g. 'npm test', 'pytest -q')",
"timeoutSeconds": "number (optional, default 180, max 3600)",
"maxOutputLength": "number (optional, default 8000, max 200000)"
}


**行为:**

- 如果 `command` 不提供,自动检测并使用默认测试命令
- 将输出截断到最后 `maxOutputLength` 字符(针对AI消费进行了优化)
- 超时时终止命令并返回“超时”信息

**示例提示:**

- 运行此项目的测试,总结输出,并解释失败的可能根本原因
- “运行所有测试,总结最近的输出,并分析哪些测试可能爆炸。

### `test_read_coverage`

读取JSON覆盖率摘要,并返回总体覆盖率和最低覆盖率文件。

**输入:**```json
{
"projectPath": "string (optional, absolute path)",
"coverageFile": "string (optional, e.g. 'coverage/coverage-summary.json')",
"topNLowestFiles": "number (optional, default 10, max 50)"
}

行为:

  • 如果 coverageFile 未提供,尝试常见的Jest/Vitest位置
  • 从以下位置读取行/语句/函数/分支覆盖率 total 领域
  • 返回第一个 topNLowestFiles 行覆盖率最低的文件

示例提示:

  • “阅读Jest覆盖率摘要,告诉我哪5个文件的行覆盖率最低。”
  • “阅读覆盖范围摘要,并说出覆盖范围最低的5个文件。

test_generate_skeleton

为给定的主题和框架样式生成测试文件骨架(describe/it block)。

输入:```json
{
"framework": "string (optional, 'jest' | 'vitest' | 'mocha', default: 'jest')",
"testFilePath": "string (required, e.g. 'src/utils/math.test.ts')",
"subjectName": "string (required, e.g. 'sum' or 'ImageProcessor')",
"description": "string (optional, high-level description)"
}


**行为:**

- 生成 `describe` / `it` 或 `assert` 基于框架的骨架
- 在描述块中包括文件路径和主题名称
- 以字符串形式返回骨架(文件写入决定权留给用户)

**示例提示:**

- “为src/utils/math.ts生成一个Jest测试框架,重点是求和函数。”
- "`src/utils/math.ts` 内部 `sum` 为其功能生成Jest测试骨架。 ”

### `test_summarize_output`

解析原始测试输出(Jest/Vitest/Mocha/Pytest风格),并返回失败测试的结构化摘要和高级统计数据。

**输入:**```json
{
"rawOutput": "string (required, raw test output or CI log chunk)",
"maxFailures": "number (optional, default 50, max 200)"
}

行为:

  • 从中提取文件名 FAIL ... 线条
  • 从中提取Jest/Vitest故障名称 ● suite › test 线条
  • 捕获 Test Suites: 和 Tests: 摘要行
  • 猜测框架类型(frameworkGuess 现场)
  • 返回失败列表 file, title,以及 rawBlock 对于每个错误

示例提示:

  • “给定这个Jest输出,按文件对失败的测试进行分组,并简要解释每个失败。”
  • “按照这个Jest输出的文件对测试进行分组,并简要解释为什么每个测试都会爆炸。

使用示例

检测框架```

"Detect the test framework and show me the default test command for this project."
"Bu projede hangi test framework'ü kullanılıyor?"


### 运行测试```
"Run all tests now and summarize the failing ones for me."
"Şimdi testleri çalıştır, eğer hata varsa bana kısa bir özet çıkar."

阅读报道```

"Read the coverage report and show files with lowest coverage."
"Coverage raporunu oku ve en düşük coverage'a sahip dosyaları göster."


### 生成测试骨架```
"Generate a Jest test skeleton for src/utils/math.ts focusing on the sum function."
"`src/utils/math.ts` içindeki `sum` fonksiyonu için Jest test iskeleti üret."

CLI命令```bash

node dist/index.js --help # Show help
node dist/index.js # Start MCP server (used by Cursor)


## 项目结构```
cursor-test-mcp/
├── src/
│   ├── index.ts              # Entry point with CLI
│   ├── server.ts             # MCP Server implementation
│   ├── tools/
│   │   └── test-tools.ts     # All test-related tools
│   └── utils/
│       └── logger.ts         # Logging utility
├── dist/                     # Compiled JavaScript
├── package.json
├── tsconfig.json
├── install.sh                # Installation script
├── LICENSE
└── README.md

支持的框架

这 test_detect_framework 该工具支持以下检测:

Node.js:

  • 杰斯特(via jest 或 ts-jest 依赖关系)
  • Vitest(通过 vitest 依赖性)
  • 摩卡(via mocha 依赖性)
  • 通用npm/yarn/pnpm测试脚本

python

  • pytest(通过 pytest.ini, pyproject.toml,或 requirements.txt)

包装经理:

  • npm(默认)
  • 纱线(通过以下方式检测 yarn.lock 或 .yarnrc)
  • pnpm(通过检测 pnpm-lock.yaml)

错误处理

服务器包括强大的错误处理功能:

  • 超时管理:测试命令的可配置超时(默认180秒,最大3600秒)
  • 输出截断:长输出被截断以防止AI上下文溢出
  • 详细错误:错误消息包括解决提示
  • 优雅关闭:正确清理信号情报/信号机信号
  • 框架检测回退:如果检测失败,则返回“未知”框架

环境变量

变量 描述 必填
LOG_LEVEL 日志级别(debug, info, warn, error,默认值: info) 没有
PROJECT_ROOT 默认项目根目录(可选) 否
MCP_MODE MCP传输模式(应为 stdio 光标) 否

如果 PROJECT_ROOT 设置后,测试将在该目录中运行 projectPath 未提供。

贡献

欢迎投稿!请随时提交拉取请求。

  1. 复刻仓库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add some amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

开发说明

  • 语言:TypeScript
  • MCP-SDK: @modelcontextprotocol/sdk
  • 入口点: src/index.ts → src/server.ts
  • 工具: src/tools/test-tools.ts
  • 日志记录器: src/utils/logger.ts

贡献:

  1. 克隆存储库或在现有目录中工作
  2. 根据您的测试/覆盖场景添加新的MCP工具(test_*)
  3. 构建于 npm run build 并在Cursor中进行测试

参考验证场景

此MCP在一个复杂的Jest项目上进行了手动验证,包括:

  • 多个测试文件(tests/math.test.ts, tests/userService.test.ts)
  • 成功和故意失败的测试
  • 异步测试和域错误(例如。, USER_INACTIVE, USER_NOT_ADMIN)
  • 测试 --coverage 生成的 coverage/coverage-summary.json

工具结果:

  • test_detect_framework → 正确检测到Jest+ npm test 命令
  • test_run → 正确携带2条失败/13条通过/15条信息和错误消息
  • test_read_coverage → 返回与Jest控制台表匹配的全局覆盖率和最低覆盖率文件
  • test_summarize_output → 按文件和测试名称正确分组失败的测试

该场景可作为参考,以证明MCP工具在现实和具有挑战性的项目中的表现符合预期。

许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。

致谢

  • Alican Kiraz -MCP生态系统的启示
  • n8n -工作流自动化平台(供MCP模式参考)
  • Anthropic -模型上下文协议
  • 光标 -AI驱动的IDE

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Cursor Test MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Cursor Test MCP 怎么在 Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Cursor Test MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Cursor Test MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Cursor Test MCP 支持哪些客户端?

资料标注支持 Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Cursor Test MCP 能提供哪些能力?

资料显示能力标签包括 测试框架、TypeScript、Cursor。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。