项目简介 PMAT (Pragmatic AI Labs Multi-language Agent Toolkit) 是一款功能强大的多语言智能体工具包，旨在为AI代理（如Claude Code, Cline等）提供高质量、AI就绪的代码上下文。它能够深入分析代码库，评估代码质量、复杂性和技术债务，并支持生成定制化的Prompt模板，以实现高度可定制的LLM交互模式。PMAT的核心价值在于其“零配置”特性，开箱即用，支持超过17种编程语言。

主要功能点

• AI就绪上下文生成: 自动为Claude、GPT等大型语言模型生成深度、结构化的代码上下文信息，帮助LLM更好地理解代码库。
• 技术债务评级 (TDG): 提供A+到F的全面技术债务评分，包含6个正交指标，并支持Git提交关联追踪。
• 代码质量与健康评分: 分析代码质量、圈复杂度，并量化评估仓库健康度（0-110分制）和Rust项目质量（0-211分制）。
• 工作流提示 (Workflow Prompts): 内置11个预配置的AI工作流提示，遵循极限TDD和丰田生产方式原则，支持变量替换以适应多语言项目。
• 突变测试 (Mutation Testing): 通过引入代码突变来评估测试套件的质量，支持Rust, Python, TypeScript等多种语言。
• 语义代码搜索: 支持自然语言的语义代码搜索，提升代码发现效率。
• 质量门禁: 提供预提交钩子和CI/CD集成，确保代码质量不回退。
• MCP服务器集成: 将PMAT的19项核心功能作为MCP工具暴露，供兼容的LLM客户端调用。

安装步骤 PMAT可以通过多种方式安装：

• Rust (推荐): 确保您的系统已安装Rust和Cargo，然后运行：

  cargo install pmat
  

• macOS / Linux: 使用Homebrew进行安装：

  brew install pmat
  

• Windows: 使用Chocolatey进行安装：

  choco install pmat
  

• npm (全球安装):

  npm install -g pmat-agent
  

MCP服务器配置 要将PMAT作为MCP服务器集成到您的LLM客户端，您需要提供服务器的启动命令和参数。以下是推荐的MCP服务器配置信息，请根据您的实际安装路径调整'command'：

• server_name: (字符串) 您MCP客户端中显示的服务器名称，例如 "PMAT MCP Server"。
• command: (字符串) 'pmat'可执行文件的完整路径。例如，如果通过'cargo install'安装，通常在'~/.cargo/bin/pmat'；如果通过Homebrew安装，则在'/usr/local/bin/pmat'。
• args: (字符串数组) 启动MCP服务器的命令行参数。对于PMAT，通常是'["agent", "mcp"]'。

基本使用方法

1. 启动MCP服务器: 运行以下命令以启动PMAT MCP服务器，它会等待MCP客户端连接并发送请求：

   pmat agent mcp
   

   （注意：通常您不需要手动运行此命令，而是由MCP客户端在后台启动和管理。）

2. 通过MCP客户端调用工具: 一旦PMAT MCP服务器运行，任何兼容的MCP客户端都可以通过JSON-RPC协议与之通信，调用其提供的19项工具。例如，客户端可以请求“analyze_complexity”工具来分析代码复杂性，或请求“context”工具来获取AI就绪的代码上下文。具体的调用方式取决于您使用的MCP客户端。

3. 命令行直接使用 (非MCP模式): 您也可以直接通过命令行使用PMAT的强大功能，例如：

   • 生成AI就绪上下文:

     pmat context --output context.md --format llm-optimized
     

   • 分析代码复杂度:

     pmat analyze complexity --language rust
     

   • 评估技术债务等级:

     pmat analyze tdg --include-components
     

   • 运行突变测试:

     pmat mutate --target src/ --threshold 85