MCP Server Spinnaker

🚀 SpinnakerのMCPサーバー

このパッケージは、Spinnakerの統合にModel Context Protocol (MCP) サーバーの実装を提供します。AIモデルが標準化されたMCPインターフェースを通じて、Spinnakerのデプロイ、パイプライン、アプリケーションと相互作用できるようにします。

🚀 クイックスタート

このMCPサーバーは、Spinnakerのデプロイ、パイプライン、アプリケーションとAIモデルを接続し、AIによるCI/CDの可能性を開拓します。以下では、その主要な機能や使い方を紹介します。

✨ 主な機能

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): 指定された環境のすべてのデプロイを取得します。

📚 ドキュメント

環境変数の設定

サーバーは以下の環境変数で設定できます。

• GATE_URL：Spinnaker GateサービスのURL
• MCP_PORT：MCPサーバーが動作するポート（デフォルト：3000）
• REFRESH_INTERVAL：コンテキストの更新間隔（秒、デフォルト：30）

型定義

パッケージはTypeScriptの型をエクスポートしています。

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

開発

コードを貢献するには、以下の手順を実行します。

1. リポジトリをクローンします。
2. 依存関係をインストールします：yarn install
3. プロジェクトをビルドします：yarn build
4. テストを実行します：yarn test

📄 ライセンス

MITライセンス - 詳細は LICENSE を参照してください。