sd-api-mcp 0.2.0__tar.gz

sd_api_mcp-0.2.0/.claude/rules/development.md

@@ -0,0 +1,41 @@
+# 開発原則
+
+このプロジェクトではt-wada式TDD・YAGNI・SOLID・DRYの原則を厳密に守ります。
+
+## TDD（t-wada 式）
+
+- **Red → Green → Refactor** の順を必ず守る
+- コードより先にテストを書く
+- テストが通る最小限の実装のみ書く（Greenフェーズ）
+- リファクタは全テストがGreenの状態でのみ行う
+- テストなしでコード変更を行わない
+
+## YAGNI（You Aren't Gonna Need It）
+
+- 現在の要件に明示されていない機能は実装しない
+- 将来の拡張を見越した抽象化・インタフェース追加は行わない
+- 不要なオプション引数・設定値・フラグは作らない
+- 「あると便利かもしれない」という理由だけでコードを書かない
+
+## SOLID
+
+- **S (Single Responsibility)**: 各モジュールは1つの責務のみ持つ
+  - `server.py` = MCP プロトコル層のみ
+  - `client.py` = Stable Diffusion API通信のみ
+- **O (Open/Closed)**: 変更にはテストを書いてから着手する
+- **I (Interface Segregation)**: インタフェースはクライアントが必要とするメソッドのみ定義する
+  - 不要なメソッドを生やさない
+- **D (Dependency Inversion)**: 上位レイヤーは下位レイヤーの具体型に依存しない
+
+## DRY（Don't Repeat Yourself）
+
+- 重複するロジックは共通ヘルパーに集約する
+- テストの共通セットアップは conftest.py フィクスチャに集約する
+- エラー変換パターンは1か所に集める
+- コピペコードを避ける
+
+## コメント
+
+- デフォルトはコメント不要
+- WHYが非自明な場合のみコメントを書く
+- 「何をしているか」は良い命名で表現する

sd_api_mcp-0.2.0/.claude/settings.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "language": "japanese",
+  "model": "claude-sonnet-4-6",
+  "attribution": {
+    "commit": "",
+    "pr": ""
+  },
+  "enabledMcpjsonServers": [
+    "plugin_serena_serena"
+  ],
+  "statusLine": {
+    "type": "command",
+    "command": ".claude/statusline.sh"
+  },
+  "enabledPlugins": {
+    "superpowers@claude-plugins-official": true,
+    "pyright-lsp@claude-plugins-official": true,
+    "context7@claude-plugins-official": true,
+    "bash-language-server@claude-code-lsps": true,
+    "criticalthink@criticalthink": true
+  },
+  "extraKnownMarketplaces": {
+    "claude-code-lsps": {
+      "source": {
+        "source": "github",
+        "repo": "boostvolt/claude-code-lsps"
+      }
+    },
+    "criticalthink": {
+      "source": {
+        "source": "github",
+        "repo": "abagames/slash-criticalthink"
+      }
+    }
+  }
+}

sd_api_mcp-0.2.0/.claude/statusline.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+set -u
+
+input=$(cat)
+MODEL=$(printf '%s' "$input" | jq -r '.model.display_name // "unknown"')
+PCT=$(printf '%s' "$input" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)
+
+if BRANCH=$(git branch --show-current 2>/dev/null) && [ -n "$BRANCH" ]; then
+    echo "${MODEL} | ${PCT}% | ${BRANCH}"
+else
+    echo "${MODEL} | ${PCT}%"
+fi

sd_api_mcp-0.2.0/.devcontainer/Dockerfile

@@ -0,0 +1,32 @@
+FROM debian:bookworm-slim
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    curl git ca-certificates gnupg jq shellcheck \
+    && rm -rf /var/lib/apt/lists/*
+
+# GitHub CLI (gh)
+RUN install -d -m 0755 /etc/apt/keyrings \
+    && curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg \
+       -o /etc/apt/keyrings/githubcli-archive-keyring.gpg \
+    && chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg \
+    && echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" \
+       > /etc/apt/sources.list.d/github-cli.list \
+    && apt-get update && apt-get install -y --no-install-recommends gh \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN groupadd --gid 1000 vscode \
+    && useradd --uid 1000 --gid 1000 --create-home --shell /bin/bash vscode
+USER vscode
+
+# mise (Python + Node.js version management)
+ENV PATH="/home/vscode/.local/share/mise/shims:/home/vscode/.local/bin:$PATH"
+RUN curl https://mise.run | sh && mise use --global python@3.13 node@22
+
+# uv (Python package manager)
+RUN curl -LsSf https://astral.sh/uv/install.sh | env UV_INSTALL_DIR=/home/vscode/.local/bin sh
+
+# bash-language-server (consumed by the claude-code-lsps bash plugin)
+RUN npm install -g bash-language-server pyright
+
+# Claude Code (native install, stable channel)
+RUN curl -fsSL https://claude.ai/install.sh | bash -s stable

sd_api_mcp-0.2.0/.devcontainer/devcontainer.json

@@ -0,0 +1,33 @@
+{
+    "name": "sd-api-mcp",
+    "dockerComposeFile": "docker-compose.yml",
+    "service": "app",
+    "workspaceFolder": "/workspaces/sd-api-mcp",
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "astral-sh.ty",
+                "charliermarsh.ruff",
+                "ms-python.python",
+                "tamasfe.even-better-toml",
+                "anthropic.claude-code"
+            ],
+            "settings": {
+                "python.defaultInterpreterPath": "${containerWorkspaceFolder}/.venv/bin/python",
+                "python.analysis.typeCheckingMode": "off",
+                "ty.enable": true,
+                "editor.formatOnSave": true,
+                "editor.defaultFormatter": "charliermarsh.ruff",
+                "[python]": {
+                    "editor.defaultFormatter": "charliermarsh.ruff",
+                    "editor.codeActionsOnSave": {
+                        "source.organizeImports": "explicit"
+                    }
+                },
+                "ruff.nativeServer": "on"
+            }
+        }
+    },
+    "postCreateCommand": "bash .devcontainer/postCreate.sh",
+    "remoteUser": "vscode"
+}

sd_api_mcp-0.2.0/.devcontainer/docker-compose.yml

@@ -0,0 +1,15 @@
+version: '3.8'
+
+services:
+  app:
+    build:
+      context: ..
+      dockerfile: .devcontainer/Dockerfile
+    env_file:
+      - ../.env
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+    volumes:
+      - ..:/workspaces/sd-api-mcp:cached
+    working_dir: /workspaces/sd-api-mcp
+    command: sleep infinity

sd_api_mcp-0.2.0/.devcontainer/postCreate.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Python/Node バージョンをインストール
+mise trust
+mise install
+
+# Python 依存関係をインストール
+uv sync --dev
+uv tool install ty
+
+# pre-commit フックをインストール
+uv run pre-commit install
+
+# Claude Code プラグインをインストール
+claude plugin install superpowers@claude-plugins-official
+claude plugin install pyright-lsp@claude-plugins-official
+claude plugin install context7@claude-plugins-official
+claude plugin install bash-language-server@claude-code-lsps
+claude plugin install criticalthink@criticalthink

sd_api_mcp-0.2.0/.env.example

@@ -0,0 +1,6 @@
+# Stable Diffusion WebUI が別の開発コンテナで動いている場合は host.docker.internal を使用
+SD_WEBUI_URL=http://host.docker.internal:7860
+SD_AUTH_USER=
+SD_AUTH_PASS=
+SD_OUTPUT_DIR=./output
+REQUEST_TIMEOUT=300

sd_api_mcp-0.2.0/.github/CODEOWNERS

@@ -0,0 +1 @@
+* @HizZaniya

sd_api_mcp-0.2.0/.github/pull_request_template.md

@@ -0,0 +1,135 @@
+<!-- PRタイトルの形式：type(scope): 命令形の説明（日本語可）
+
+  例：
+    feat(server): generate_image ツールを追加
+    fix(client): タイムアウト時のリトライ処理を修正
+    refactor(client): HTTPセッション管理をヘルパーに集約
+    chore: fastmcp を 3.4.0 にアップデート
+    ci: ruff CI ジョブを追加
+-->
+
+## 概要
+
+<!-- 必須。2〜4文で「何を・なぜ」変更するか記述すること。
+     ユーザーへの影響またはエンジニアリング上の理由に焦点を当てる。
+     関連Issueがある場合はリンクを記載：「Closes #123」または「Ref #456」 -->
+
+## ラベル
+
+<!-- 必ず1つだけチェックし、GitHub UI（右サイドバー > Labels）でも同じラベルを付与すること。
+     ラベルは `gh release create --generate-notes` のカテゴリ分類に使われる。 -->
+
+- [ ] `breaking-change`  — MCPツールのシグネチャ変更など、利用者対応が必要な変更
+- [ ] `feature`          — 新しいツール・機能の追加
+- [ ] `enhancement`      — 既存ツール・機能の改善
+- [ ] `bug`              — ユーザー影響のあるリグレッション
+- [ ] `fix`              — リグレッションでない不具合修正
+- [ ] `server`           — MCP プロトコル層の変更（`server.py`）
+- [ ] `client`           — SD WebUI API 通信層の変更（`client.py`）
+- [ ] `performance`      — 計測可能な速度・メモリ改善（ベンチマーク結果必須）
+- [ ] `docs`             — ドキュメントのみ（README、インラインコメント、ガイド）
+- [ ] `ci`               — GitHub Actions ワークフローの変更
+- [ ] `build`            — pyproject.toml・uv・ツールチェーンの設定変更
+- [ ] `dependencies`     — 依存関係のバージョン更新
+- [ ] `skip-changelog`   — リリースノートから意図的に除外するもの
+
+## 完了条件（Definition of Done）
+
+> **マージ前に全項目をチェックすること。未チェック項目があるPRはマージ不可。**
+> 適用外の項目は理由をコメントで明記した上でチェックすること。
+
+### CI/CD（自動チェック）
+
+- [ ] `lint` ジョブがグリーン（`uv run ruff check .`）
+- [ ] `format` ジョブがグリーン（`uv run ruff format --check .`）
+- [ ] `type-check` ジョブがグリーン（`uv run ty check`）
+- [ ] `test` ジョブがグリーン（`uv run pytest`）
+
+### コード品質（手動確認）
+
+- [ ] `uv run ruff check .` がローカルで警告ゼロで通過する
+- [ ] `uv run ruff format --check .` がローカルで差分ゼロで通過する
+- [ ] `uv run ty check` がローカルでエラーゼロで通過する
+- [ ] デバッグ用 `print()` がプロダクションコードに残っていない
+- [ ] ハードコードされた認証情報・URLが含まれていない
+
+### テスト（手動確認）
+
+- [ ] TDDサイクル（Red → Green → Refactor）を完了した
+- [ ] 新規ロジックに対応するテストが書かれている
+- [ ] `uv run pytest` がローカルで全テストグリーンで通過する
+
+### アーキテクチャ（レイヤー分離）
+
+- [ ] `server.py` に SD WebUI API 直接呼び出しがない（MCP プロトコル層のみ）
+- [ ] `client.py` に MCP ツール定義がない（API 通信層のみ）
+
+## テスト証跡
+
+<!-- CI設定・ドキュメントのみの変更はこのセクションを削除すること -->
+
+### 追加・変更したテスト
+
+| テストファイル | 追加・変更したテストケース名 |
+|--------------|--------------------------|
+| <!-- 例: tests/test_client.py --> | <!-- 例: test_generate_image_timeout --> |
+
+### 手動確認手順
+
+<!-- ローカルで実施したハッピーパスと異常系を記載する。手順が自明な場合は省略可 -->
+
+1.
+2.
+
+## セキュリティチェック
+
+<!-- 新規機能を追加した場合のみ記入すること。
+     既存機能の修正・ドキュメント変更では「適用外」とだけ記載すること（セクション自体は残す）。 -->
+
+- [ ] ユーザー入力（プロンプト・パラメータ）がバリデーションされている
+- [ ] 認証情報（SD_AUTH_USER / SD_AUTH_PASS）がログ・レスポンスに漏洩しない
+- [ ] エラーレスポンスに機密情報が含まれていない
+- [ ] 環境変数以外の方法で認証情報を受け取っていない
+
+## パフォーマンス影響
+
+- [ ] パフォーマンスへの影響を確認した
+
+**影響の有無と理由：**
+<!-- `performance` ラベル：ベンチマーク結果（before / after）を以下に貼り付けること -->
+<!-- その他のラベル：「影響なし。〇〇のみの変更のため」と一行で記載 -->
+
+## 破壊的変更
+
+<!-- `breaking-change` ラベルの場合のみ記入すること。
+     それ以外のPRでは「適用外」とだけ記載すること（セクション自体は残す）。 -->
+
+### 変更前後の動作
+
+**変更前：** <!-- 旧動作を説明 -->
+
+**変更後：** <!-- 新動作を説明 -->
+
+### 移行手順
+
+<!-- MCPクライアント側が対応するための手順を記載する。 -->
+
+## レビュアーへの案内
+
+### 重点的にレビューしてほしい部分
+
+<!-- どこを特に見てほしいか、その理由とともに記載する -->
+
+-
+
+### テストが難しかった部分・未テストの部分
+
+<!-- テストを書かなかった・書けなかった部分とその理由を明記する。なければ「なし」と記載 -->
+
+-
+
+### 設計上の判断とトレードオフ
+
+<!-- 他の実装アプローチを検討した場合、なぜこの設計を選んだかを説明する。自明な場合は「なし」と記載 -->
+
+-

sd_api_mcp-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,48 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          python-version: "3.13"
+      - run: uv sync --frozen --group dev
+      - run: uv run ruff check .
+
+  format:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          python-version: "3.13"
+      - run: uv sync --frozen --group dev
+      - run: uv run ruff format --check .
+
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          python-version: "3.13"
+      - run: uv sync --frozen --group dev
+      - run: uv run ty check
+
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          python-version: "3.13"
+      - run: uv sync --frozen --group dev
+      - run: uv run pytest -v

sd_api_mcp-0.2.0/.github/workflows/pr-template-check.yml

@@ -0,0 +1,40 @@
+name: PR Template Check
+
+on:
+  pull_request:
+    types: [opened, edited, reopened, synchronize]
+    branches: [main]
+
+jobs:
+  validate-template:
+    name: PR Template Validation
+    runs-on: ubuntu-latest
+    steps:
+      - name: Validate required sections and label
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const body = context.payload.pull_request.body ?? '';
+
+            const required = [
+              '## 概要',
+              '## ラベル',
+              '## 完了条件',
+              '## パフォーマンス影響',
+              '## レビュアーへの案内',
+            ];
+
+            const missing = required.filter(s => !body.includes(s));
+            const hasLabel = /- \[x\]/i.test(body);
+
+            const errors = [];
+            if (missing.length > 0) {
+              errors.push(`必須セクションが不足しています:\n${missing.map(s => `  • ${s}`).join('\n')}`);
+            }
+            if (!hasLabel) {
+              errors.push('ラベルが未選択です（## ラベル セクションで `- [x]` を1つチェックしてください）');
+            }
+
+            if (errors.length > 0) {
+              core.setFailed(errors.join('\n\n'));
+            }

sd_api_mcp-0.2.0/.github/workflows/publish.yml

@@ -0,0 +1,107 @@
+name: Publish to PyPI
+
+on:
+  workflow_run:
+    workflows: [Release]
+    types: [completed]
+  workflow_dispatch:
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  build:
+    if: ${{ github.event_name == 'workflow_dispatch' || github.event.workflow_run.conclusion == 'success' }}
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: main
+
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          python-version: "3.13"
+
+      - name: Extract version
+        id: version
+        run: |
+          VERSION=$(python3 -c "import tomllib; d=tomllib.loads(open('pyproject.toml').read()); print(d['project']['version'])")
+          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
+
+      - run: uv build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-testpypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: testpypi
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          skip-existing: true
+
+  verify-testpypi:
+    needs: [build, publish-testpypi]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Wait and verify TestPyPI installation
+        env:
+          VERSION: ${{ needs.build.outputs.version }}
+        run: |
+          for i in $(seq 1 10); do
+            pip install \
+              --index-url https://test.pypi.org/simple/ \
+              --extra-index-url https://pypi.org/simple/ \
+              "sd-api-mcp==${VERSION}" && break
+            [ "$i" -eq 10 ] && { echo "All retries failed"; exit 1; }
+            echo "Retry ${i}/10..."
+            sleep 30
+          done
+          python -c "import sd_api_mcp; print('import OK')"
+
+  publish-pypi:
+    needs: verify-testpypi
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  install-test:
+    needs: [build, publish-pypi]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Wait for PyPI propagation
+        run: sleep 60
+
+      - name: Install and verify from PyPI
+        env:
+          VERSION: ${{ needs.build.outputs.version }}
+        run: |
+          pip install "sd-api-mcp==${VERSION}"
+          python -c "import sd_api_mcp; print('import OK')"

sd_api_mcp-0.2.0/.github/workflows/release.yml

@@ -0,0 +1,46 @@
+name: Release
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          python-version: "3.13"
+
+      - run: uv sync --frozen --group dev
+
+      - name: Configure git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Bump version
+        run: uv run cz bump --yes
+
+      - name: Push commits and tags
+        run: git push origin main --follow-tags
+
+      - name: Extract version
+        id: version
+        run: |
+          VERSION=$(python3 -c "import tomllib; d=tomllib.loads(open('pyproject.toml').read()); print(d['project']['version'])")
+          echo "version=v${VERSION}" >> "$GITHUB_OUTPUT"
+
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh release create "${{ steps.version.outputs.version }}" \
+            --generate-notes \
+            --title "${{ steps.version.outputs.version }}"

sd_api_mcp-0.2.0/.gitignore

@@ -0,0 +1,24 @@
+# Claude Code
+.claude/settings.local.json
+
+# Serena
+.serena/
+
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+.venv/
+*.egg-info/
+dist/
+build/
+
+# Tools cache
+.ruff_cache/
+.pytest_cache/
+.mypy_cache/
+
+# Environment
+.env
+.env.*
+!.env.example

sd_api_mcp-0.2.0/.mise.toml

@@ -0,0 +1,3 @@
+[tools]
+python = "3.13"
+node = "22"

sd_api_mcp-0.2.0/.pre-commit-config.yaml

@@ -0,0 +1,24 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.9
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: local
+    hooks:
+      - id: ty
+        name: ty type check
+        entry: uv run ty check
+        language: system
+        types: [python]
+        pass_filenames: false
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml

sd_api_mcp-0.2.0/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+## [0.1.0] - 2026-06-25
+
+### Features
+
+- `txt2img`: テキストプロンプトから画像を生成
+- `img2img`: 入力画像とプロンプトから画像を生成
+- `get_sd_models`: 利用可能な Stable Diffusion モデル一覧を取得
+- `set_sd_model`: アクティブモデルを変更
+- `get_sd_upscalers`: 利用可能なアップスケーラー一覧を取得
+- `upscale_images`: 画像をアップスケーリング
+- `get_controlnet_models`: ControlNet モデル一覧を取得
+- `get_controlnet_modules`: ControlNet プリプロセッサ一覧を取得
+
+## v0.2.0 (2026-06-25)
+
+### Fix
+
+- **ci**: guard publish against failed release and add retry exit code
+
+## v0.1.0 (2026-06-25)
+
+### Feat
+
+- SDWebUIClientとMCPツール8個を実装
+- プロジェクト初期セットアップ
+
+### Fix
+
+- **client**: type: ignore を assert isinstance に置き換えて型チェックを通す