MCP Server Spinnaker

🚀 Spinnaker 的 MCP 服務器

此包為 Spinnaker 集成提供了 Model Context Protocol (MCP) 服務器實現，讓 AI 模型能借助標準化的 MCP 接口，與 Spinnaker 的部署、管道和應用進行交互，極大提升了軟件部署流程的智能化水平。

🚀 快速開始

本 MCP 服務器可助力 AI 模型與 Spinnaker 集成，以下是簡單的使用步驟：

1. 完成服務器的安裝（具體安裝方式見“📦 安裝指南”）。
2. 按照“💻 使用示例”中的代碼示例進行初始化和操作。

✨ 主要特性

AI 集成

這個 MCP 服務器展示了 Anthropic 新的 AI 模型 Claude 如何直接集成並增強軟件部署流程，遵循 MCP 標準。Claude 可以訪問豐富的上下文信息，瞭解 Spinnaker 應用、管道和部署的狀態，並通過定義良好的工具主動管理它們。AI 驅動的 CI/CD 具備以下顯著特性：

1. 智能部署決策：AI 模型憑藉對應用和管道狀態的全面瞭解，能夠分析並做出何時何地進行部署的明智決策。例如，Claude 可以查看測試覆蓋率、代碼變更情況和歷史成功率，以確定最佳的部署時間和目標環境。
2. 主動問題檢測與自動修復：AI 會持續監控 CI/CD 進程，提前發現潛在問題。例如，Claude 發現新依賴版本存在已知漏洞時會自動創建拉取請求進行更新，或者注意到部署時間過長而主動增加資源以防止超時。
3. 持續流程優化：每次部署後，AI 都會學習和適應，不斷優化 CI/CD 進程。Claude 可以分析構建和部署日誌，識別瓶頸並提出改進建議。
4. 上下文更新：服務器自動維護關於 Spinnaker 部署的上下文信息，包括應用列表及其狀態、管道狀態、當前部署以及最近的管道執行情況。

📦 安裝指南

可使用 npm 或 yarn 進行安裝：

npm install @airjesus17/mcp-server-spinnaker
# 或者
yarn add @airjesus17/mcp-server-spinnaker

💻 使用示例

基礎用法

import { SpinnakerMCPServer } from '@airjesus17/mcp-server-spinnaker';

// 創建 MCP 服務器實例
const server = new SpinnakerMCPServer({
  gateUrl: 'http://localhost:8050', // 必填：Spinnaker Gate 服務 URL
  port: 3000, // 可選：MCP 服務器端口，默認為 3000
});

// 啟動服務器
await server.start();

高級用法

提供的工具

• getApplications(): 獲取所有 Spinnaker 應用。
• getPipelines(applicationId: string): 獲取指定應用的所有管道。
• getDeployments(environment: string): 獲取指定環境的所有部署。

📚 詳細文檔

環境變量配置

服務器可通過以下環境變量進行配置：

類型定義

包導出了 TypeScript 類型以供使用：

import type {
  SpinnakerApplication,
  SpinnakerPipeline,
  SpinnakerDeployment,
  SpinnakerExecution
} from '@airjesus17/mcp-server-spinnaker';

開發

要貢獻代碼，可按以下步驟操作：

1. 克隆倉庫。
2. 安裝依賴：yarn install。
3. 構建項目：yarn build。
4. 運行測試：yarn test。

📄 許可證

本項目採用 MIT License，詳情請見 LICENSE。