MCP 服务器

MCP Server Make

一个模型上下文协议服务器，它使大型语言模型（LLM）能够安全地执行 Makefile 中的 make 目标，从而允许 AI 助手通过自然语言交互来运行测试、格式化代码和自动化各种开发任务。

Tools

make

Run a make target from the Makefile

README

MCP Server Make

一个提供 make 功能的模型上下文协议服务器。该服务器使 LLM 能够以安全、受控的方式执行任何 Makefile 中的 make 目标。

概述

该服务器通过模型上下文协议公开 make 功能，允许像 Claude 这样的 LLM：

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

MCP Server Make 适用于任何有效的 Makefile - 您可以使用包含的 opinionated Makefile 或您自己的自定义构建脚本。

快速开始

安装

使用 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"
      ]
    }
  }
}

文档

有关使用 MCP Server Make 的详细信息，请参阅我们的文档：

用户指南 - 安装、配置和使用的完整指南
自定义 Makefiles - 创建与 MCP Server Make 一起使用的有效 Makefiles

增强开发工作流程

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

对于开发者

自动化辅助
- 让 Claude 运行并解释测试结果
- 获取构建系统建议和改进
- 自动化重复的开发任务
项目管理
- 让 Claude 处理依赖更新
- 自动化发布流程
- 保持一致的代码质量

使用 Make 目标

MCP Server Make 不会自动发现 Makefile 中可用的目标。为了有效地与 Claude 一起使用它：

从 make help 开始: 大多数设计良好的 Makefiles 都包含一个 help 目标
```
Human: 请运行 make help 以查看有哪些可用的命令。
```

告诉 Claude 您的目标: 明确提及可用的目标及其用途

Human: 我们的项目有这些 make 目标：test, lint, format, build, 和 clean。

使用标准约定: 许多 Makefiles 包含的常见目标：
- make test - 运行测试
- make lint - 检查代码质量
- make format - 格式化代码
- make build - 构建项目
- make clean - 清理构建产物

该存储库包含一个 opinionated Makefile，其中包含额外的实用程序目标 - 有关这些扩展功能或创建您自己的自定义目标的详细信息，请参阅用户指南。

注意: Claude 不会记住对话之间可用的目标。您需要在每次对话开始时介绍它们。

示例集成

以下是 Claude 如何帮助完成开发任务：

Human: 你能运行我们的测试套件并格式化任何需要格式化的代码吗？

Claude: 我将帮助运行测试并格式化代码：

1. 首先，让我们格式化代码：
[Calling make tool with args {"target": "format"}]
2 files reformatted, 3 files left unchanged

2. 现在让我们运行测试：
[Calling make tool with args {"target": "test"}]
Running tests...
4 passed, 0 failed

所有格式化和测试均已成功完成。 代码现在已正确格式化，并且所有测试均已通过。