Zen of Languages
🖌️ Write code the way the language intended.
- 348禅宗原则 跨编程、标记、工作流和配置域
- 367个探测器/检查覆盖点 严重程度评分
- MCP服务器 用于IDE和代理工作流(13个工具、3个资源、1个提示)
- CLI报告 带有修正提示和JSON/PMarkdown导出
- 规则驱动的管道 可按语言和项目进行配置
为什么选择MCP进行Zen分析
MCP将zen分析从独立报告转变为交互式工程循环。您的编辑器/代理可以直接调用zen工具,检查上下文中的违规行为,生成补救提示,并在一个流中应用修复,而不是在工具之间复制输出。
- 减少上下文切换:在不离开编码会话的情况下进行分析、解释和补救。
- 高保真修复:提示是由结构化违规生成的,而不是特殊的lint文本。
- 团队一致性:MCP工作流使审查行为在IDE和代理之间可重复。
禅宗哲学
语言禅将习语视为工程约束,而不是风格偏好。每个语言指南都对使代码在该生态系统中可维护的实践进行了编码,然后根据风险对违规行为进行评分,这样团队就可以先解决重要的问题。
- 语言母语质量 超过一种尺寸适合所有棉绒。
- 建筑反馈 除了格式检查。
- 可操作的优先级 通过严重性指导的补救措施。
该项目由 禅宗的十大信条 --一组与语言无关的原则,驱动着每个检测器和架构决策。阅读完整的哲学文档,了解反模式、基本原理和检测器映射。
快速启动```bash
MCP server (IDE/agent workflows)
uvx --from mcp-zen-of-languages mcp-zen-of-languages-server
CLI without installing (recommended)
uvx --from mcp-zen-of-languages mcp-zen-of-languages-cli --help
Or install globally
pip install mcp-zen-of-languages
Analyze a file (CLI)
mcp-zen-of-languages-cli report path/to/file.py
Analyze a project with remediation prompts (CLI)
mcp-zen-of-languages-cli report path/to/project --include-prompts
安装后,旧别名仍然可用: `zen` 对于CLI和
`zen-mcp-server` 对于MCP服务器。
### 分析过程中忽略文件
CLI和MCP存储库分析荣誉中的目录扫描:
- `.gitignore`
- `.zen-of-languages.ignore`
`zen init` 现在,先发先发 `.zen-of-languages.ignore` 文件丢失时。
## 命名指南
保持这些名称不同,以避免设置混淆:
- **包名**: `mcp-zen-of-languages` (为 `pip install` 和 `uvx --from`)
- **首选CLI命令**: `mcp-zen-of-languages-cli`
- **首选服务器命令**: `mcp-zen-of-languages-server`
- **兼容性别名**: `mcp-zen-of-languages`, `zen`,以及 `zen-mcp-server`
- **MCP客户端服务器密钥**: `zen-of-languages` (VS Code/Claude/Cursor中的JSON配置标签;在Codex中使用与引用的TOML表名相同的标签)
## 安装
### MCP集成
将服务器添加到MCP客户端配置中。有关完整的设置指南,请参阅 MCP集成.
**克劳德桌面** --添加到 `claude_desktop_config.json`:```json
{
"mcpServers": {
"zen-of-languages": {
"command": "uvx",
"args": ["--from", "mcp-zen-of-languages", "mcp-zen-of-languages-server"]
}
}
}
VS Code --添加到 .vscode/mcp.json:```json
{
"servers": {
"zen-of-languages": {
"command": "uvx",
"args": ["--from", "mcp-zen-of-languages", "mcp-zen-of-languages-server"]
}
}
}
**光标** --添加到 `.cursor/mcp.json`:```json
{
"mcpServers": {
"zen-of-languages": {
"command": "uvx",
"args": ["--from", "mcp-zen-of-languages", "mcp-zen-of-languages-server"]
}
}
}
法典 --添加到 ~/.codex/config.toml:```toml
[mcp_servers."zen-of-languages"]
command = "uvx"
args = ["--from", "mcp-zen-of-languages", "mcp-zen-of-languages-server"]
enabled = true
Codex从全球加载MCP服务器 `~/.codex/config.toml` 文件,而不是repo本地工作区配置。
### 一键(VS代码)
|方法| VS代码| VS代码内部人员|
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **UVX** (本地)| | |
| **码头工人** (孤立)| | |
### 码头工人```bash
# MCP server via Docker
docker run --rm -i ghcr.io/anselmoo/mcp-zen-of-languages:latest
# CLI via Docker
docker run --rm ghcr.io/anselmoo/mcp-zen-of-languages:latest mcp-zen-of-languages-cli --help
CLI——第一代码分析
CLI是一个强大的工具 第一次代码记忆 --对任何代码库的初始诊断扫描。在连接MCP或选择要关注的文件之前,运行一个命令以获取完整的项目健康状况图,包括严重程度排名的违规、架构气味和补救指南。```bash
Install globally
pip install mcp-zen-of-languages
Full-project diagnostic in one command
mcp-zen-of-languages-cli report path/to/project --include-prompts
Export structured results for CI or dashboards
mcp-zen-of-languages-cli report path/to/project --export-json report.json --export-markdown report.md
来源:```bash
git clone https://github.com/Anselmoo/mcp-zen-of-languages.git
cd mcp-zen-of-languages
uv sync --all-groups --all-extras
# Start the MCP server
mcp-zen-of-languages-server
# Run a CLI report
mcp-zen-of-languages-cli report path/to/file.py
MCP工具
服务器暴露 13工具, 3资源,以及 1个提示 用于AI辅助代码分析。
| 家庭 | 工具 | 目的 |
|---|---|---|
| 分析 | analyze_zen_violations, analyze_repository, check_architectural_patterns |
习语与结构分析 |
| 报告 | generate_prompts, generate_agent_tasks, generate_report |
补救指导、任务清单、差距报告 |
| 配置 | get_config, set_config_override, clear_config_overrides |
在运行时读取并调整阈值 |
| 元数据 | detect_languages, get_supported_languages, export_rule_detector_mapping |
发现语言、规则、探测器覆盖范围 |
| 入职 | onboard_project |
初始化 zen-config.yaml 对于一个项目 |
查看完整 MCP工具参考 用于参数、返回类型和工作流图。
用例
- AI代码审查 --呼叫
analyze_zen_violations在一个文件上,然后generate_prompts在单个编辑器的往返中获取补救说明。 - 项目范围差距分析 —
analyze_repository扫描代码库,generate_report生成Markdown/JSON报告,以及generate_agent_tasks创建优先级修复列表。 - 一键入职 —
onboard_project检测语言并编写优化的zen-config.yaml,立即进行项目意识分析。
支持的语言
| 层级 | 语言 | 注释 |
|---|---|---|
| 稳定 | Python | 完整解析器+最丰富的检测器覆盖率 |
| 贝塔 | Pydantic、FastAPI、Django、SQLAlchemy、TypeScript、React、Angular、Next.js、Go、Rust、JavaScript、Vue | 规则驱动的管道和框架感知启发式 |
| 实验性 | Bash、PowerShell、Ruby、C++、C# | 启发式检测器 |
| 数据/配置 | YAML、TOML、JSON/JSON5、XML、GitHub操作 | 结构、模式和工作流检查 |
配置
分析管道源自语言zen规则,并与中的项目覆盖合并 zen-config.yaml。请参阅 配置指南 以获取完整参考。```bash
Generate reports in multiple formats
zen report path/to/project --export-json report.json --export-markdown report.md
```
文档
完整文档可在 anselmoo.github.io/mcp-zen语言.
贡献
看 添加语言 和 开发指南 开始吧。
许可证
麻省理工学院
