Wrale MCP Server Make

🚀 MCP 服務器構建

MCP 服務器構建項目提供了一個基於 Model Context Protocol 的服務器構建功能，允許 LLM 按照 Makefile 安全、受控地執行 make 目標，助力開發者實現高效的開發工作流。

🚀 快速開始

本服務器通過 Model Context Protocol 提供構建功能，讓 LLM 能夠安全執行 make 目標、理解構建過程、協助開發任務、處理錯誤並尊重工作目錄上下文。

✨ 主要特性

• 使 LLM 能安全執行 make 目標並捕獲輸出。
• 幫助 LLM 理解和導航構建過程。
• 協助開發者完成開發任務。
• 能正確處理錯誤情況。
• 尊重工作目錄上下文。

📦 安裝指南

使用 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

高級用法

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

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

📚 詳細文檔

開發工作流的增強

對於開發者

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 文件。