适合谁
- 使用AI编码助手（如Claude Code、Cursor）的开发者和团队
- 拥有多个上下文文件和复杂项目结构的项目
- 需要维护代理上下文准确性的专业团队
- 对MCP配置安全性（如硬编码API密钥）有严格要求的环境
C
57FMRS · C
Ctxlint作为MCP服务器提供全面的上下文文件、MCP配置、会话和技能审计功能。工具集均衡，只读工具支持自动批准注释以简化工作流。它需要读取目标项目文件，对于利用其CLI和MCP服务器功能的团队价值高。非官方但遵循MIT许可且文档齐全。
Ctxlint是一个专为AI工具上下文文件设计的lint工具。它读取CLAUDE.md、AGENTS.md、.cursorrules、.mcp.json等文件，并与你的实际代码库交叉比对，以捕捉过时的路径、错误的命令、冗余内容、跨文件矛盾等问题。它支持16种AI工具和8种MCP客户端，可作为CLI、CI步骤、pre-commit hook或MCP服务器运行。该MCP服务器提供7个工具用于审计上下文文件、MCP配置、会话数据和技能定义。
工具能力
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历史）。
安装接入
### 通过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"
]
}
}
}
选型与风险
不适合谁
- 不使用AI上下文文件的普通开发项目
- 只使用单人、简单项目且不更新文件的情形（可能过度）
- 不需要严格上下文维护的非关键项目
所需权限
- 读取项目目录中的上下文文件和配置文件（如CLAUDE.md、.mcp.json）
- 可选：读取用户级别的配置文件（如~/.claude/settings.json）和全局MCP配置（需--mcp-global）
- 可选：当启用会话或技能审计时，读取用户主目录中的代理历史文件（如~/.claude/history.jsonl）和记忆文件
- 可选：启用--fix时写入上下文文件以修复错误的路径
风险与副作用
- 自动修复（--fix）可能意外修改文件；建议先预览（--fix-dry-run）并审查更改。
- 会话审计访问主目录中的敏感历史文件；仅在可信环境中启用。
- 工具会读取配置和上下文文件，可能包含敏感信息（如API密钥）；确保访问权限受控。
- 冗余检查可能误报，因为推断的内容可能因上下文而异。
常见排障
- 确保你的项目包含要审计的上下文文件（如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编码会话前自动审计上下文文件，确保代理遵循最新代码结构。
持续集成（CI）中作为检查步骤，防止上下文文件与实际代码漂移。
团队协作时统一多个上下文文件的规则，避免冲突指令。
通过MCP服务器集成到IDE或编码助手，实时获取lint结果。
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Cursor完整支持
Windsurf完整支持
VS Code完整支持
GitHub Copilot完整支持