Ctxlint

社区

Lint你的AI代理上下文文件（CLAUDE.md、AGENTS.md等）是否符合你的实际代码库。

分类: 开发工具第 158 / 438
Stars: ★ 11 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 无需凭据
许可证: MIT
最近提交: 14 天前
工具数: 7

57FMRS · C

Ctxlint作为MCP服务器提供全面的上下文文件、MCP配置、会话和技能审计功能。工具集均衡，只读工具支持自动批准注释以简化工作流。它需要读取目标项目文件，对于利用其CLI和MCP服务器功能的团队价值高。非官方但遵循MIT许可且文档齐全。

最强项 · 文档质量 15/20 最弱项 · 可靠性 9/20

可靠性

9/20

安全与权限

11/20

维护活跃度

9/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 9/20: README 宣称提供 7 个 MCP 工具（ctxlint_audit 等）并附带只读注解，stdio 传输、零运行时依赖、单包启动路径清晰，且 manifest 与 npm 包名/版本一致，happy path 可信。但评审仅限静态材料：未见服务器源码、测试用例或 CI 工作流证明工具行为与声明一致（如工具参数、错误输出），错误处理与边界情况不可验证，无法超过 12 分。
安全与权限 11/20: 无红线风险：不联网、声称只读、对检测到的密钥仅显示 6 字符前缀、高危的 --fix 需交互确认、session/skills/global 等越界扫描均为 opt-in 并有明确范围说明，权限设计意识较好。但安全声明均为 README 自述，未在源码中核实密钥脱敏逻辑、--fix 写入路径约束及 home 目录扫描的实际边界，只能给中等分。
维护活跃度 9/20: 版本号 0.24.1 显示活跃迭代，MIT 许可明确，npm/GitHub 徽章齐全。但 7 星热度低，未见 issue 响应、发布节奏、安全响应渠道或贡献者治理的证据，版本仍在 0.x，未达持续维护标准。
文档质量 15/20: README 极为详尽：安装方式、CLI 全部选项、配置文件字段表、7 个 MCP 工具列表、多客户端配置示例、退出码、四种输出格式及四份规格文档，文档分层良好。扣分点：未提供 MCP 工具的参数 schema 说明、故障排查章节、token 消耗/成本细节；README 自述版本（v0.9.10 示例）与 manifest 0.24.1 不一致，且部分声明（规则数量、客户端支持）无法在静态材料中验证。
安装易用性 13/20: 安装路径清晰：npx 一行即用，提供 Claude Code、.mcp.、VS Code、Claude Desktop 的完整配置示例（含 Windows cmd /c 包装），npm 包与 manifest 一致，安装复杂度低。扣分：未提供 stderr 日志/调试指引，Windows 下 npx 依赖 cmd 包装略脆弱，且缺少运行验证步骤（如何确认握手成功）。

静态评测 · 未实际运行收录于 2026-09-08

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件

适合谁

使用AI编码助手（如Claude Code、Cursor）的开发者和团队
拥有多个上下文文件和复杂项目结构的项目
需要维护代理上下文准确性的专业团队
对MCP配置安全性（如硬编码API密钥）有严格要求的环境

不适合谁

不使用AI上下文文件的普通开发项目
只使用单人、简单项目且不更新文件的情形（可能过度）
不需要严格上下文维护的非关键项目

所需权限

读取项目目录中的上下文文件和配置文件（如CLAUDE.md、.mcp.json）
可选：读取用户级别的配置文件（如~/.claude/settings.json）和全局MCP配置（需--mcp-global）
可选：当启用会话或技能审计时，读取用户主目录中的代理历史文件（如~/.claude/history.jsonl）和记忆文件
可选：启用--fix时写入上下文文件以修复错误的路径

风险与副作用

自动修复（--fix）可能意外修改文件；建议先预览（--fix-dry-run）并审查更改。
会话审计访问主目录中的敏感历史文件；仅在可信环境中启用。
工具会读取配置和上下文文件，可能包含敏感信息（如API密钥）；确保访问权限受控。
冗余检查可能误报，因为推断的内容可能因上下文而异。

安装接入

准备工作

运行环境：Node.js

### 通过npx运行（无需安装）

npx -y @yawlabs/ctxlint@latest serve

### 添加到MCP客户端
对于支持项目级MCP配置的客户端（如Claude Code、Cursor、Windsurf），在项目根目录创建.mcp.json文件：

{
  "mcpServers": {
    "ctxlint": {
      "command": "npx",
      "args": ["-y", "@yawlabs/ctxlint@latest", "serve"]
    }
  }
}

对于Claude Desktop，在claude_desktop_config.json中添加相同的配置。

对于VS Code / GitHub Copilot，在.vscode/mcp.json中使用相同的服务器配置（但使用"servers"作为根键）。

claude_desktop_config.json

{
  "mcpServers": {
    "ctxlint": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/ctxlint@latest",
        "serve"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "ctxlint": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/ctxlint@latest",
        "serve"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add ctxlint -- npx -y @yawlabs/ctxlint@latest serve

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

运行 npx -y @yawlabs/ctxlint@latest serve 后，在客户端工具列表中确认出现 ctxlint_audit、ctxlint_fix 等 7 个 ctxlint_* 工具。

常见排障

确保你的项目包含要审计的上下文文件（如CLAUDE.md）。如果没有，MCP服务器可能报告没有文件可审计。
如果使用会话或技能审计，检查是否传递了正确的标志（--session、--skills）以及相应的文件是否存在。
在Windows上，使用npx时需要添加`cmd /c`包装器：`"command": "cmd", "args": ["/c", "npx", "-y", "@yawlabs/ctxlint@latest", "serve"]`。
如果无法启动服务器，确认已安装Node.js和npx，并网络可访问npm注册表。
对于路径错误，请检查输出中的建议路径，或启用--fix来自动修复（在版本控制中审查更改）。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

审计我的 CLAUDE.md 和 AGENTS.md，找出失效路径和过时的命令
检查我的 .mcp. 里有没有硬编码的密钥或废弃的 SSE 传输
报告我的上下文文件每份占用多少 token，哪些内容是冗余的
用 git 历史自动修复上下文文件中损坏的路径

工具能力 7

ctxlint_audit 只读

审计项目的上下文文件（如CLAUDE.md、AGENTS.md等），检查路径、命令、过期、冗余等。

ctxlint_mcp_audit 只读

审计MCP配置文件（.mcp.json、.cursor/mcp.json等），检查schema、安全、命令、废弃传输等。

ctxlint_session_audit 只读

审计AI代理会话数据（历史记录、记忆），检查跨项目的秘密、配置漂移、陈旧记忆和循环检测。

ctxlint_skill_audit 只读

审计Claude Code技能和代理定义（~/.claude/skills、~/.claude/agents），检查frontmatter、引用、触发器冲突等。

ctxlint_validate_path 只读

验证路径是否存在于项目中，并根据git历史建议正确的路径。

ctxlint_token_report 只读

报告上下文文件的token消耗及冗余内容。

ctxlint_fix 写入

自动修复上下文文件中的损坏路径（使用git历史）。

使用场景

在AI编码会话前自动审计上下文文件，确保代理遵循最新代码结构。

持续集成（CI）中作为检查步骤，防止上下文文件与实际代码漂移。

团队协作时统一多个上下文文件的规则，避免冲突指令。

通过MCP服务器集成到IDE或编码助手，实时获取lint结果。

支持客户端

Claude Desktop

Claude Code

Cursor

Windsurf

VS Code

GitHub Copilot

依据项目文档列出，未经本站实测。

详细介绍

Ctxlint是一个专为AI工具上下文文件设计的lint工具。它读取CLAUDE.md、AGENTS.md、.cursorrules、.mcp.json等文件，并与你的实际代码库交叉比对，以捕捉过时的路径、错误的命令、冗余内容、跨文件矛盾等问题。它支持16种AI工具和8种MCP客户端，可作为CLI、CI步骤、pre-commit hook或MCP服务器运行。该MCP服务器提供7个工具用于审计上下文文件、MCP配置、会话数据和技能定义。