MCP Zen Of Languages

Zen of Languages

🖌️ Write code the way the language intended.

______________________________________________________________________

一 用于AI助手的MCP服务器 这将把多语言惯用代码分析带入您的编辑器。Zen of Languages将最佳实践（“Zen原则”）编码为跨编程语言、CI自动化和配置格式的机器可读规则，因此AI代理和开发人员在每次审查中都能获得可操作的、有语言意识的反馈。将其连接到 Codex、Claude Desktop、VS Code、Cursor或任何兼容MCP的客户端 并在几秒钟内开始分析代码。

• 348禅宗原则 跨编程、标记、工作流和配置域
• 367个探测器/检查覆盖点 严重程度评分
• MCP服务器 用于IDE和代理工作流（13个工具、3个资源、1个提示）
• CLI报告 带有修正提示和JSON/PMarkdown导出
• 规则驱动的管道 可按语言和项目进行配置

为什么选择MCP进行Zen分析

MCP将zen分析从独立报告转变为交互式工程循环。您的编辑器/代理可以直接调用zen工具，检查上下文中的违规行为，生成补救提示，并在一个流中应用修复，而不是在工具之间复制输出。

• 减少上下文切换：在不离开编码会话的情况下进行分析、解释和补救。
• 高保真修复：提示是由结构化违规生成的，而不是特殊的lint文本。
• 团队一致性：MCP工作流使审查行为在IDE和代理之间可重复。

禅宗哲学

语言禅将习语视为工程约束，而不是风格偏好。每个语言指南都对使代码在该生态系统中可维护的实践进行了编码，然后根据风险对违规行为进行评分，这样团队就可以先解决重要的问题。

• 语言母语质量 超过一种尺寸适合所有棉绒。
• 建筑反馈 除了格式检查。
• 可操作的优先级 通过严重性指导的补救措施。

该项目由 禅宗的十大信条 --一组与语言无关的原则，驱动着每个检测器和架构决策。阅读完整的哲学文档，了解反模式、基本原理和检测器映射。

快速启动

# 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:

{
  "mcpServers": {
    "zen-of-languages": {
      "command": "uvx",
      "args": ["--from", "mcp-zen-of-languages", "mcp-zen-of-languages-server"]
    }
  }
}

VS Code --添加到 .vscode/mcp.json:

{
  "servers": {
    "zen-of-languages": {
      "command": "uvx",
      "args": ["--from", "mcp-zen-of-languages", "mcp-zen-of-languages-server"]
    }
  }
}

光标 --添加到 .cursor/mcp.json:

{
  "mcpServers": {
    "zen-of-languages": {
      "command": "uvx",
      "args": ["--from", "mcp-zen-of-languages", "mcp-zen-of-languages-server"]
    }
  }
}

法典 --添加到 ~/.codex/config.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代码）

码头工人

# 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或选择要关注的文件之前，运行一个命令以获取完整的项目健康状况图，包括严重程度排名的违规、架构气味和补救指南。

# 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

来源：

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辅助代码分析。

查看完整 MCP工具参考 用于参数、返回类型和工作流图。

用例

1. AI代码审查 --呼叫 analyze_zen_violations 在一个文件上，然后 generate_prompts 在单个编辑器的往返中获取补救说明。
2. 项目范围差距分析 — analyze_repository 扫描代码库， generate_report 生成Markdown/JSON报告，以及 generate_agent_tasks 创建优先级修复列表。
3. 一键入职 — onboard_project 检测语言并编写优化的 zen-config.yaml，立即进行项目意识分析。

支持的语言

配置

分析管道源自语言zen规则，并与中的项目覆盖合并 zen-config.yaml。请参阅 配置指南 以获取完整参考。

# Generate reports in multiple formats
zen report path/to/project --export-json report.json --export-markdown report.md

文档

完整文档可在 ****.

贡献

许可证

麻省理工学院

______________________________________________________________________