Docker AIのGordonがなんだか使いにくかったので
MCP風にラップしてKiro CLIに使ってもらってみた

% docker.exe ai
>>> こんにちは

  ��                                                                                        こ��                                                                                      こん��                                                                                    こんに��                                                                                  こんにち��                                                                                こんにちは��                                                                              こんにちは！Docker��                                                                      こんにちは！Dockerや��                                                                    こんにちは！Dockerや技��                                                                  こんにちは！Dockerや技術��                                                                こんにちは！Dockerや技術関��                                                              こんにちは！Dockerや技術関連��                                                            こんにちは！Dockerや技術関連の��                                                          こんにちは！Dockerや技術関連の質��                                                        こんにちは！Dockerや技術関連の質問��                                                      こんにちは！Dockerや技術関連の質問が��                                                    こんにちは！Dockerや技術関連の質問があ��                                                  こんにちは！Dockerや技術関連の質問があれ��                                                こんにちは！Dockerや技術関連の質問があれば��                                              こんにちは！Dockerや技術関連の質問があれば、��                                            こんにちは！Dockerや技術関連の質問があれば、何��                                          こんにちは！Dockerや技術関連の質問があれば、何で��                                        こんにちは！Dockerや技術関連の質問があれば、何でも��                                      こんにちは！Dockerや技術関連の質問があれば、何でも聞��                                    こんにちは！Dockerや技術関連の質問があれば、何でも聞いて��                                こんにちは！Dockerや技術関連の質問があれば、何でも聞いてく��                            
  �                                                                                         ��                                                                                        �さ                                                                                       �さ�                                                                                      �さ��                                                                                     �さい                                                                                     �さい�                                                                                    �さい��                                                                                   �さい。                                                                                   �さい。�                                                                                  �さい。��                                                                                 �さい。ど                                                                                 �さい。ど�                                                                                �さい。ど��                                                                               �さい。どう                                                                               �さい。どう�                                                                              �さい。どう��                                                                             �さい。どうぞ                                                                             �さい。どうぞ�                                                                            �さい。どうぞ��                                                                           �さい。どうぞお                                                                           �さい。どうぞお�                                                                          �さい。どうぞお��                                                                         �さい。どうぞお気                                                                         �さい。どうぞお気�                                                                        �さい。どうぞお気��                                                                       �さい。どうぞお気軽                                                                       �さい。どうぞお気軽�                                                                      �さい。どうぞお気軽��                                                                     �さい。どうぞお気軽に                                                                     �さい。どうぞお気軽に�                                                                    �さい。どうぞお気軽に��                                                                   �さい。どうぞお気軽に！                                                                   �さい。どうぞお気軽に！ �                                                                 �さい。どうぞお気軽に！ ��
  �さい。どうぞお気軽に！ ���
  �さい。どうぞお気軽に！ 😊                                                              


                                                           👍 Helpful 👎 Not helpful

"""Gordon MCP Server - FastMCP implementation."""

import subprocess
import re
from typing import Optional
from fastmcp import FastMCP

mcp = FastMCP("Gordon Docker AI")

def run_docker_ai(question: str, working_dir: Optional[str] = None, timeout: int = 60) -> str:
    """Execute docker ai command and return the response."""
    import os

    enhanced_question = f"{question}\n\nPlease provide a complete answer in one response without asking follow-up questions."
    cmd = ["docker.exe", "ai"]

    if working_dir:
        expanded_dir = os.path.expanduser(working_dir)
        abs_dir = os.path.abspath(expanded_dir)

        if abs_dir.startswith('/'):
            import subprocess as sp
            try:
                win_path = sp.run(['wslpath', '-w', abs_dir], 
                                capture_output=True, text=True, timeout=5).stdout.strip()
                cmd.extend(["--working-dir", win_path])
            except Exception:
                cmd.extend(["--working-dir", abs_dir])
        else:
            cmd.extend(["--working-dir", abs_dir])

    cmd.append(enhanced_question)

    try:
        result = subprocess.run(cmd, capture_output=True, text=True, timeout=timeout, encoding='utf-8', errors='ignore')
        output = result.stdout + result.stderr
        cleaned = clean_output(output)

        if not cleaned:
            return "Error: No response from Gordon"
        if result.returncode != 0 and len(cleaned) < 100:
            return f"Error executing docker ai: {cleaned}"

        return cleaned
    except subprocess.TimeoutExpired:
        return f"Error: Command timed out after {timeout} seconds"
    except Exception as e:
        return f"Error: {str(e)}"

def clean_output(output: str) -> str:
    """Clean up Gordon's streaming output."""
    output = re.sub(r'\x1b\[[0-9;]*[a-zA-Z]', '', output)
    lines_to_remove = [
        r'Working on your request.*', r'Searching my knowledge base.*',
        r'Sending tool call results.*', r'UNC.*', r'.*CMD\.EXE.*',
        r'.*Windows.*', r'.*\\wsl\.localhost\\.*', r'.*cmd\.exe.*',
        r'.*powershell\.exe.*', r'➜.*', r'.*\x00.*', r'^[^\x20-\x7E\s]+$',
    ]

    for pattern in lines_to_remove:
        output = re.sub(pattern, '', output, flags=re.MULTILINE)

    lines = [line.strip() for line in output.split('\n') if line.strip()]
    result = '\n'.join(lines)

    prev_line = None
    cleaned_lines = []
    for line in result.split('\n'):
        if line != prev_line:
            cleaned_lines.append(line)
            prev_line = line

    return '\n'.join(cleaned_lines).strip()

@mcp.tool()
def ask_gordon(question: str) -> str:
    """Ask Gordon (Docker AI) any question about Docker."""
    return run_docker_ai(question)

@mcp.tool()
def analyze_file(file_path: str, context: Optional[str] = None) -> str:
    """Ask Gordon to analyze a Docker-related file and provide recommendations."""
    import os

    expanded_path = os.path.expanduser(file_path)
    if not os.path.exists(expanded_path):
        return f"Error: File not found at {expanded_path}"

    dir_path = os.path.dirname(expanded_path) or "."
    filename = os.path.basename(expanded_path)

    question = f"Analyze the {filename} file and provide recommendations"
    if context:
        question += f". Context: {context}"

    return run_docker_ai(question, working_dir=dir_path)

def main():
    """Run the MCP server."""
    mcp.run(transport='stdio')

if __name__ == "__main__":
    main()

> Dockerfileのベストプラクティスについて教えてください

Running tool ask_gordon with the param (from mcp server: gordon)
 ⋮  {
 ⋮    "question": "What are the best practices for writing a Dockerfile? Please provide comprehensive guidance on optimization, security, maintainability, and common patterns."
 ⋮  }

Allow this action? Use 't' to trust (always allow) this tool for the session. [y/n/t]:

> y

 - Completed in 25.987s

> Dockerfileのベストプラクティスについて、以下の観点から説明します。

## 最適化

1. マルチステージビルドの使用
   - ビルドステージと本番ステージを分けることで、最終イメージのサイズを削減

dockerfile
   # ビルドステージ
   FROM node:16 AS build
   WORKDIR /app
   COPY package*.json ./
   RUN npm install
   COPY . .
   RUN npm run build

   # 本番ステージ
   FROM nginx:alpine
   COPY --from=build /app/build /usr/share/nginx/html



2. 適切なベースイメージの選択
   - alpineやdebian-slimなどの軽量で信頼できるイメージを使用
   - Docker Hubの公式イメージを優先

3. 複数行の引数をソート
   - アルファベット順にソートすることで、メンテナンスしやすく重複を防止

dockerfile
   RUN apt-get update && apt-get install -y --no-install-recommends \
       curl \
       git \
       vim \
       && rm -rf /var/lib/apt/lists/*



4. レイヤーの最小化
   - コマンドを結合してレイヤー数を削減

dockerfile
   RUN apt-get update && apt-get install -y curl && rm -rf /var/lib/apt/lists/*



5. .dockerignoreの使用
   - 不要なファイルをビルドコンテキストから除外

   node_modules
   *.log
   .git


## セキュリティ

1. ベースイメージのバージョン固定
  dockerfile
   FROM ubuntu:20.04


2. rootユーザーを避ける

dockerfile
   RUN addgroup --system appgroup && adduser --system appuser --ingroup appgroup
   USER appuser



3. 不要なパッケージをインストールしない
  dockerfile
   RUN apt-get install -y --no-install-recommends curl


4. 定期的なイメージの再ビルド
   - セキュリティパッチを含めるため、--no-cacheオプションを使用
  bash
   docker build --no-cache -t my-image:latest .


5. エフェメラルコンテナの使用
   - ステートレスで使い捨て可能な設計にする

## メンテナンス性

1. 明確なコメントの使用

dockerfile
   # 依存関係のインストール
   RUN apt-get update && apt-get install -y curl



2. 環境変数の活用
  dockerfile
   ENV PORT=3000
   EXPOSE $PORT


3. 依存関係のキャッシュ最適化
  dockerfile
   COPY package*.json ./
   RUN npm install
   COPY . .


## 一般的なパターン

1. CMDでデフォルトコマンドを定義
  dockerfile
   CMD ["npm", "start"]


2. ENTRYPOINTで固定コマンドを定義
  dockerfile
   ENTRYPOINT ["python3", "app.py"]


3. 必要なポートのみ公開
  dockerfile
   EXPOSE 8080


4. ラベルでメタデータを追加
  dockerfile
   LABEL maintainer="your-email@example.com"


これらのベストプラクティスに従うことで、最適化され、安全で、メンテナンスしやすい
Dockerfileを作成できます。
 ▸ Time: 42s

> ./Dockerfileを解析してください

Running tool analyze_file with the param (from mcp server: gordon)
 ⋮  {
 ⋮    "file_path": "./Dockerfile"
 ⋮  }

Allow this action? Use 't' to trust (always allow) this tool for the session. [y/n/t]:

> y

 - Completed in 14.723s

> Dockerfileの解析結果です。

## 現在の構成

1. FROM ubuntu:latest - Ubuntuの最新版をベースイメージとして使用
2. RUN apt-get update - パッケージリストを更新
3. RUN apt-get install -y python3 - Python 3をインストール
4. RUN apt-get install -y python3-pip - pipをインストール
5. RUN apt-get install -y curl - curlをインストール
6. RUN apt-get install -y git - Gitをインストール
7. COPY . /app - カレントディレクトリの内容を/appにコピー
8. WORKDIR /app - 作業ディレクトリを/appに設定
9. RUN pip3 install flask - Flaskをインストール
10. RUN pip3 install requests - requestsライブラリをインストール
11. RUN pip3 install psycopg2-binary - PostgreSQL用ライブラリをインストール
12. CMD python3 app.py - app.pyを実行するデフォルトコマンド

## 改善推奨事項

1. RUNコマンドの統合
  レイヤー数を削減するため、apt-getコマンドを1つにまとめる:

dockerfile
   RUN apt-get update && apt-get install -y python3 python3-pip curl git && apt-get clean && rm -rf /var/lib/apt/lists/*



2. ベースイメージのバージョン固定
  ubuntu:latestを特定バージョン（例: ubuntu:20.04）に変更

3. Pythonパッケージのバージョン固定

dockerfile
   RUN pip3 install flask==2.3.2 requests==2.31.0 psycopg2-binary==2.9.7


4. .dockerignoreの使用
  不要なファイル（.git、node_modulesなど）を除外

5. セキュリティ改善
  rootユーザーでの実行を避ける:
  dockerfile
   RUN useradd -m appuser
   USER appuser


6. ヘルスチェックの追加
  dockerfile
   HEALTHCHECK CMD curl --fail http://localhost:5000 || exit 1


7. マルチステージビルドの検討
  最終イメージサイズを最適化

これらの改善により、Dockerfileはより効率的で安全、かつメンテナンスしやすくなります。
 ▸ Time: 30s