laozofficial/checked-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

0 stars 0 forks 质量 83 趋势 14MIT

Repository Install

MCP服务器允许AI助手（Claude Code、Cursor、VS Code）使用Check'd： runs、results、AI报告、发现和使用情况。

概览

一个MCP服务器（stdio），让AI助手使用Check'd：读取运行结果、AI报告和发现及其证据，并且在你要求时启动运行、重跑失败测试或扫描网站。需要Node.js 20或更高版本。基于官方MCP TypeScript SDK和@checked/cli核心构建。 - CHECKED_API_KEY：工作区API密钥（设置，应用中的API密钥）。仅访问该工作区。- 或CHECKED_TOKEN，或通过该机器的登录检查保存。- CHECKED_API_URL：仅在使用非[[T0]的服务器时] 没有凭证，服务器仍然会启动;每个工具都会回答如何登录。光标（.cursor/mcp.json，或每个项目的~/.cursor/mcp.json）： VS Code（.vscode/mcp.json;VS Code 只要求输入密钥一次：开始工作或改变事情（readOnlyHint：错误;描述中说他们使用了津贴）：每个工具都会返回一个可读的文本答案以及它构建的JSON。

概述（AI 翻译）

一个MCP服务器（stdio），让AI助手使用Check’d：读取运行结果、AI报告和发现及其证据，并且在你要求时启动运行、重跑失败测试或扫描网站。

需要Node.js 20 或更高版本。基于官方 MCP TypeScript SDK 和 checkd-cli 核心构建。

资历

CHECKED_API_KEY：一个工作区API密钥（设置，应用中的API密钥）。仅访问该工作区。
或 CHECKED_TOKEN，或本机器中由 checked login 保存的登录。
CHECKED_API_URL：仅限于使用除https://getchecked.twelveai.app以外的服务器。

没有凭证，服务器仍然会启动;每个工具都会回答如何登录。

加入它

克劳德代码：

光标（[.cursor/mcp.json，或每个项目的~/.cursor/mcp.json）：

VS Code （[.vscode/mcp.json;VS Code 只要求输入密钥一次）：

工具

只读（免费;readOnlyHint: true）：

工具	它的作用
`whoami`	哪个账户或密钥，工作区，计划
`list_projects`	项目上一次运行
`list_environments`	项目环境（隐藏秘密）
`list_runs`	近期运行

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

checkd-mcp

An MCP server (stdio) that lets AI assistants use Check’d: read run results, AI reports and findings with their evidence, and, when you ask, start runs, re-run failed tests or scan a website.

Needs Node.js 20 or newer. Built on the official MCP TypeScript SDK and the checkd-cli core.

Credentials

CHECKED_API_KEY: a workspace API key (Settings, API keys in the app). Reaches that workspace only.
or CHECKED_TOKEN, or the sign-in saved by checked login on this machine.
CHECKED_API_URL: only if you use a server other than https://getchecked.twelveai.app.

Without a credential the server still starts; every tool answers with how to sign in.

Add it

Claude Code:

claude mcp add checked --env CHECKED_API_KEY=tfy_your_key -- npx -y checkd-mcp

Cursor (.cursor/mcp.json, or ~/.cursor/mcp.json for every project):

{
  "mcpServers": {
    "checked": { "command": "npx", "args": ["-y", "checkd-mcp"], "env": { "CHECKED_API_KEY": "tfy_your_key" } }
  }
}

VS Code (.vscode/mcp.json; VS Code asks for the key once):

{
  "inputs": [{ "type": "promptString", "id": "checked-api-key", "description": "Check’d workspace API key", "password": true }],
  "servers": {
    "checked": { "type": "stdio", "command": "npx", "args": ["-y", "checkd-mcp"], "env": { "CHECKED_API_KEY": "${input:checked-api-key}" } }
  }
}

Tools

Read-only (free; readOnlyHint: true):

Tool	What it does
`whoami`	Which account or key, workspaces, plans
`list_projects`	Projects with their last run
`list_environments`	A project’s environments (secrets masked)
`list_runs`	Recent runs
`get_run`	Status, release gates, AI verdict, top problems with finding ids
`wait_for_run`	Waits up to 600 s for a run to finish
`get_run_results`	Individual API test results
`get_run_report`	The AI QA report
`list_findings`, `get_finding`	Failed tests and scan findings; full request, response, checks, stack trace, diagnosis and fix
`list_issues`, `get_issue`	The issue inbox: production errors and test findings, with the cached AI explanation (see the seam below)
`get_usage`	Session and month usage, and whether work is blocked
`preview_import`	What an API import would add; nothing saved

Start work or change things (readOnlyHint: false; descriptions say they use allowance):

Tool	What it does
`start_run`	Start a run; optional `wait_seconds` (max 600) returns the result
`rerun_failed`	Re-run only the failed tests of a finished API run
`start_scan`	Website scan (uses or creates the workspace’s project for that host)
`import_spec`	Save endpoints from an API document
`cancel_run`	Cancel a run

Each tool returns a readable text answer plus the JSON it was built from. Errors come back as isError results; a 402 says the allowance is used up, when it resets, and not to retry.

在 GitHub 查看完整 README

安装

npx -y checkd-mcp

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "checked": { "command": "npx", "args": ["-y", "checkd-mcp"], "env": { "CHECKED_API_KEY": "tfy_your_key" } }
  }
}