Dotfile MCP Server

Dotfiles MCP Server

這是一個 MCP (Model Context Protocol) 伺服器，讓大型語言模型 (LLMs) 如 Claude 或 Copilot 可以存取並執行您的自動化腳本。 此專案旨在讓使用者無需完整複製龐大的 dotfiles 儲存庫，也能透過簡單的設定流程，快速使用這些強大的開發工具。

功能

• 自動化工具整合：自動將 bin/ 目錄下的 Shell 腳本轉換為可供 LLM 呼叫的 MCP 工具。
• 便攜式設計：內建設定腳本，自動下載所需腳本並設定環境，隨裝隨用。
• 安全路徑管理：支援動態路徑配置，確保工具在正確的環境下執行。

包含的工具腳本

安裝後，LLM 將能夠使用以下工具：

• bi-weekly-report: 自動生成雙週工作報告 (透過 GitHub PRs)
• checkout-ticket: 根據 JIRA 票號快速建立並切換開發分支
• checkout-config: 快速切換設定檔專案分支
• deploy-console: 觸發 Jenkins 部署 Console 專案
• deploy-one: 觸發 Monorepo 部署
• trace-build: 追蹤 Jenkins 建置狀態並回報進度
• review-ticket: 協助進行 Code Review

快速開始

1. 複製專案

git clone https://github.com/andrew-wu-12/dotfile-mcp-server.git
cd dotfile-mcp-server

2. 執行自動化設定

此指令會自動下載最新的腳本、安裝 NPM 相依套件，並編譯 TypeScript 程式碼。

npm run setup

3. 設定 MCP 客戶端

設定腳本執行完畢後，會直接在終端機顯示您需要的設定資訊。請根據您使用的客戶端進行設定。

Claude Desktop / OpenCode 設定

將以下 JSON 設定加入您的設定檔 (例如 claude_desktop_config.json 或 opencode.json)：

{
  "mcpServers": {
    "dotfiles": {
      "command": "node",
      "args": ["{dotfile-mcp-server 絕對路徑}/dist/index.js"],
      "env": {
        "DOTFILES_PATH": "{dotfile-mcp-server 絕對路徑}"
      }
    }
  }
}

Claude Code (CLI) 使用方式

若要在 Claude Code CLI 中直接加入此伺服器，請執行以下指令（npm run setup 結束時會提供包含正確路徑的完整指令）：

claude mcp add dotfiles -- /usr/bin/env DOTFILES_PATH="{dotfile-mcp-server 絕對路徑}" node "{dotfile-mcp-server 絕對路徑}/dist/index.js"

開發與維護

• 更新腳本: 重新執行 npm run setup 即可重新下載最新的腳本。
• 重新建置: npm run build

授權

ISC