wrale_mcp-server-make

🚀 MCP 服务器构建

一个提供构建功能的 Model Context Protocol 服务器。此服务器允许大语言模型（LLM）按照 Makefile 执行 make 目标，以安全、受控的方式运行，助力开发工作。

🚀 快速开始

该服务器通过 Model Context Protocol 提供构建功能，使 LLM 能够：

• 安全地执行 make 目标并捕获输出
• 理解和导航构建过程
• 协助开发任务
• 正确处理错误
• 尊重工作目录上下文

📦 安装指南

使用 uv（推荐）

uv pip install mcp-server-make

使用 pip

pip install mcp-server-make

💻 使用示例

基本用法

# 使用当前目录中的默认 Makefile
uvx mcp-server-make

# 使用特定的 Makefile 和工作目录
uvx mcp-server-make --make-path /path/to/Makefile --working-dir /path/to/working/dir

MCP 客户端配置

要在 Claude Desktop 中使用，请将其添加到您的 Claude 配置文件（claude_desktop_config.json）中：

{
  "mcpServers": {
    "make": {
      "command": "uvx",
      "args": [
        "mcp-server-make",
        "--make-path", "/absolute/path/to/Makefile",
        "--working-dir", "/absolute/path/to/working/dir"
      ]
    }
  }
}

示例集成

# 示例：使用自定义 Makefile 和工作目录
uvx mcp-server-make --make-path ./custom_make/Makefile --working-dir ./workdir

📚 详细文档

开发工作流的增强

该服务器通过赋予 LLM 直接访问 make 功能的能力，实现强大的开发工作流程：

对于开发者

1. 自动化辅助
   • 让 Claude 运行并解释测试结果
   • 获取构建系统建议和改进
   • 自动化重复性开发任务
   • 获得即时更改反馈
2. 项目管理
   • 让 Claude 处理依赖项更新
   • 自动化发布流程
   • 维护一致的代码质量
   • 跟踪项目状态

对于 Claude

1. 自我验证能力
   • 运行测试以验证更改：make test
   • 检查代码质量：make lint
   • 格式化代码：make format
   • 完全验证：make check
2. 项目理解
   • 查看项目结构：make x
   • 检查最近更改：make z
   • 获取完整上下文快照：make r
3. 独立开发
   • 管理完整的开发周期
   • 自我包含的测试和验证
   • 构建和准备发布
   • 生成有根据的提交消息

可用工具

该服务器提供一个工具：

• make - 从 Makefile 执行 make 目标
  • 参数：
    • --make-path <路径>: 指定要执行的 Makefile 路径，默认为当前目录中的 Makefile。
    • --working-dir <路径>: 设置工作目录，影响命令的执行环境。

错误处理

• 如果未找到指定的 Makefile，则会抛出异常： FileNotFoundError: [Errno 2] No such file or directory: 'Makefile'
• 如果在执行 make 命令时发生错误，请检查控制台输出以获取详细信息。

工作目录行为

• 服务器启动时，工作目录默认为当前目录。
• 使用 --working-dir 参数可以更改工作目录。

故障排除

• 如果遇到问题，请检查以下内容：
  • 确保指定的 Makefile 存在。
  • 检查是否有足够的权限执行 make 命令。
  • 查看控制台输出以获取错误信息。

贡献指南

• 如有贡献，请 fork 仓库并提交 pull request。
• 请遵循代码规范和提交准则。

📄 许可证

本项目采用 MIT License，详细内容请查看 LICENSE 文件。