MCP 整合

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost:5432/myapp_dev"
      ]
    }
  }
}

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost:5432/myapp_dev"
      ]
    },
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

設定鍵：

mcpServers - MCP 設定的必要頂層鍵
command - 要執行的可執行檔（Node.js 套件通常為 npx）
args - 傳遞給命令的引數（套件名稱、連線字串等）
env - 用於驗證／設定的環境變數

深入了解 MCP：

Model Context Protocol 規範
MCP Server Registry - 瀏覽可用的 MCP 伺服器
官方 MCP 伺服器 - PostgreSQL、GitHub、Filesystem 等

MCP 外掛與擴充

可用的外掛

MCP 外掛為常見工具與服務提供現成的整合。請至 mcp.so/servers 的社群登錄處，或官方 MCP 伺服器儲存庫瀏覽目前可用的項目。

常見外掛類別：

資料庫整合： PostgreSQL、MySQL、MongoDB 查詢工具
雲端服務： AWS、Azure、GCP API 互動
開發者工具： GitHub、GitLab、Jira、Linear 整合
CI/CD 平台： Jenkins、GitHub Actions、CircleCI
監控服務： Datadog、New Relic、Sentry
通訊： Slack、Discord、Microsoft Teams 通知

外掛安裝

安裝方式： 外掛透過 MCP 設定介面安裝與設定，通常需要：

外掛識別碼或來源
設定參數
驗證憑證（如適用）

相依性管理： MCP 外掛可能相依於外部服務或函式庫。安裝程序會在可能時自動處理相依性解析。

自訂 MCP 伺服器開發

建立自訂伺服器

進階使用者可建立自訂 MCP 伺服器，以整合專有工具或特定領域的系統。

開發方式： 自訂 MCP 伺服器實作 MCP 協定規範，公開可供 Verdent 呼叫的工具能力。實作細節與 SDK 請參閱 Model Context Protocol 規範。

自訂伺服器的使用情境：

內部 API 整合： 連接到公司專屬的 API 與服務
舊系統橋接： 讓 Verdent 能與舊有基礎架構互動
專屬資料來源： 存取專有資料庫或資料倉儲
工作流程自動化： 觸發自訂的建置、部署或測試流程

整合模式

工作區層級設定： MCP 伺服器可在工作區層級設定以供專案專屬整合，讓團隊能透過版本控制共用 MCP 設定。

工具互通性： MCP 提供的工具能與 Verdent 的內建工具（file_read、bash、spawn_subagent）無縫整合，實現結合多種工具類型的複雜工作流程。

Desktop 專屬的 MCP 功能

各專案個別設定

設定層級	位置	範圍
全域	`~/.verdent/mcp.json`	所有專案
專案	專案根目錄中的 `.mcp.json`	單一專案
Worktree	繼承自專案	繼承專案設定

多 Worktree MCP

MCP 伺服器可跨 worktree 運作：

共用伺服器： 基礎工作區的 MCP 設定由所有 worktree 共用
隔離操作： 每個 worktree 維護各自獨立的 MCP 工作階段狀態
並行存取： 多個 worktree 可同時使用相同的 MCP 伺服器

專案切換

切換專案時：

載入目前專案的 MCP 伺服器
全域 MCP 伺服器仍可使用
先前專案的 MCP 連線於背景中維持

MCP 工作流程範例

資料庫查詢整合

情境： 查詢正式環境資料庫以除錯資料問題。

MCP 做法：

User: "Check the orders table for customer ID 12345"
Verdent: [Uses MCP database server to execute safe read-only query]
        Results: 3 orders found for customer 12345
        [Displays formatted results]

MCP 資料庫伺服器會處理驗證、查詢驗證與結果格式化。

雲端服務互動

情境： 檢查 AWS Lambda 函式日誌以找出錯誤。

MCP 做法：

User: "Show me recent errors from the payment-processor Lambda function"
Verdent: [Invokes MCP AWS integration]
        [Retrieves CloudWatch logs for specified function]
        [Filters for ERROR level entries]
        [Presents formatted error summaries]

MCP AWS 伺服器負責管理驗證、API 呼叫與日誌解析。

CI/CD 流程監控

情境： 在部署變更前檢查建置狀態。

MCP 做法：

User: "Is the master branch build passing?"
Verdent: [Queries MCP CI/CD integration]
        Build #245: ✓ Passed (2 minutes ago)
        All tests passed, ready for deployment

MCP CI/CD 伺服器會追蹤流程狀態並提供即時回饋。