Copilot CLI Dev Environment Bootstrapping

GitHub Copilot CLI 開發環境設置

在新機器上快速復原 Copilot CLI 工作環境的完整指南。

---

前置需求

確認以下工具已安裝：

工具	用途	安裝參考
pnpm	Node.js 套件管理	請參考官方安裝頁面
PHP	PHP 執行環境	依作業系統安裝
Node.js	JS/TS 執行環境	建議透過 nvm 安裝
Python	Python 執行環境	建議透過 uv 管理

---

1. LSP Server 安裝

PHP — intelephense

pnpm add -g intelephense

Node.js / TypeScript — typescript-language-server

pnpm add -g typescript-language-server typescript

Python — pyright

pnpm add -g pyright

---

2. LSP 設定檔

建立檔案 ~/.copilot/lsp-config.json（Windows：%USERPROFILE%\.copilot\lsp-config.json）：

{
  "lspServers": {
    "intelephense": {
      "command": "intelephense",
      "args": ["--stdio"],
      "fileExtensions": {
        ".php": "php"
      }
    },
    "typescript": {
      "command": "typescript-language-server",
      "args": ["--stdio"],
      "fileExtensions": {
        ".js": "javascript",
        ".jsx": "javascriptreact",
        ".ts": "typescript",
        ".tsx": "typescriptreact",
        ".mjs": "javascript",
        ".cjs": "javascript"
      }
    },
    "pyright": {
      "command": "pyright-langserver",
      "args": ["--stdio"],
      "fileExtensions": {
        ".py": "python"
      }
    }
  }
}

---

3. MCP 設定

建立或更新 ~/.copilot/mcp.json（Windows：%USERPROFILE%\.copilot\mcp.json）：

{
  "mcpServers": {
    "context7": {
      "tools": [
        "get-library-docs",
        "resolve-library-id"
      ],
      "type": "http",
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

context7 使用遠端 HTTP 模式，不需要本地安裝任何套件。

---

4. 驗證

啟動 Copilot CLI 後，執行以下指令確認設定生效：

/lsp    → 查看 LSP server 載入狀態
/mcp    → 查看 MCP server 連線狀態

---

快速腳本（一鍵安裝）

# 1. 安裝 LSP servers
pnpm add -g intelephense typescript-language-server typescript pyright

# 2. 建立設定目錄
mkdir -p ~/.copilot

# 3. 寫入 LSP 設定
cat > ~/.copilot/lsp-config.json << 'EOF'
{
  "lspServers": {
    "intelephense": {
      "command": "intelephense",
      "args": ["--stdio"],
      "fileExtensions": {
        ".php": "php"
      }
    },
    "typescript": {
      "command": "typescript-language-server",
      "args": ["--stdio"],
      "fileExtensions": {
        ".js": "javascript",
        ".jsx": "javascriptreact",
        ".ts": "typescript",
        ".tsx": "typescriptreact",
        ".mjs": "javascript",
        ".cjs": "javascript"
      }
    },
    "pyright": {
      "command": "pyright-langserver",
      "args": ["--stdio"],
      "fileExtensions": {
        ".py": "python"
      }
    }
  }
}
EOF

# 4. 寫入 MCP 設定
cat > ~/.copilot/mcp.json << 'EOF'
{
  "mcpServers": {
    "context7": {
      "tools": [
        "get-library-docs",
        "resolve-library-id"
      ],
      "type": "http",
      "url": "https://mcp.context7.com/mcp"
    }
  }
}
EOF

Windows 使用者：請將 ~/.copilot/ 替換為 %USERPROFILE%\.copilot\，並使用 PowerShell 執行對應命令。

---

Copilot CLI 自動設置 Prompt

在新環境啟動 Copilot CLI 後，貼上以下 prompt，讓 Copilot 自行查找最新做法並完成設置：

請幫我完成 Copilot CLI 的開發環境設置：

1. 我使用 pnpm 管理所有 LSP 套件。
   請全域安裝下列語言的 LSP server（自行查找目前主流推薦的套件名稱與安裝方式）：
   - PHP
   - JavaScript / TypeScript
   - Python

2. 根據安裝結果，產生並寫入 ~/.copilot/lsp-config.json，
   設定每個 LSP server 的啟動指令與對應的副檔名。

3. 在 ~/.copilot/mcp.json 加入 context7 MCP server，
   使用官方建議的最新連線方式（HTTP remote 或本地安裝皆可，以官方文件為準）。

4. 完成後用 /lsp 和 /mcp 確認設定已正確載入，並回報結果。