開発環境との統合

Svelte MCP を開発環境に統合することで、AI 支援を最大限に活用できます。このページでは、プロジェクトへの MCP 統合から、ESLint との連携、CI/CD パイプラインへの組み込みまで、実践的な設定方法を解説します。

適切に統合された環境では、AI がコードを生成するたびに svelte-autofixer による検証が行われ、Svelte 5 の最新構文やベストプラクティスに準拠したコードが保証されます。チーム全体で統一された開発環境を構築することで、コードレビューの負担軽減と品質向上を同時に実現できます。

統合ワークフロー

以下の図は、プロジェクト初期化から品質保証までの典型的なワークフローを示しています。

ダイアグラムを読み込み中...

開発フローは大きく3つのフェーズに分かれます。初期化フェーズでプロジェクトと MCP を設定し、開発フェーズで AI 支援を受けながらコーディング、品質保証フェーズで ESLint と CI/CD による自動検証を行います。

プロジェクト初期化

新規プロジェクト

# SvelteKitプロジェクト作成
npx sv create my-app
cd my-app

# MCP設定を追加
npx sv add mcp
bash

npx sv add mcp コマンドは以下を自動的に行います。

  1. MCP サーバー設定の追加(Local または Remote)
  2. AGENTS.md(または CLAUDE.mdGEMINI.md)の作成
  3. 推奨プロンプトの追加

オプション

# IDE を指定(複数可)
npx sv add mcp="ide:cursor,vscode"

# セットアップ方式を指定
npx sv add mcp="setup:local"

# 両方指定
npx sv add mcp="ide:claude-code,setup:remote"
bash

利用可能な IDE: claude-codecursorgeminiopencodevscodeother

既存プロジェクトへの追加

cd existing-project

# MCP設定を追加
npx sv add mcp
bash

ESLint との連携

Svelte MCP と ESLint は、それぞれ異なる役割を持ちながら補完関係にあります。ESLint はファイル保存時や CI 実行時にコードスタイルと一般的なルールをチェックし、svelte-autofixer は AI との対話時に Svelte 固有の問題を検出します。

ダイアグラムを読み込み中...

svelte-autofixer は内部で svelte-eslint-parser を使用しているため、同じパーサーを ESLint でも使うことで一貫性のある解析が可能です。両者を組み合わせることで、開発中のリアルタイムフィードバックと AI 生成コードの品質保証を両立できます。

ESLint 設定

# 必要なパッケージをインストール
npm install -D eslint eslint-plugin-svelte svelte-eslint-parser
bash
// eslint.config.js
import svelte from 'eslint-plugin-svelte';
import svelteParser from 'svelte-eslint-parser';
import tsParser from '@typescript-eslint/parser';

export default [
  ...svelte.configs['flat/recommended'],
  {
    files: ['**/*.svelte'],
    languageOptions: {
      parser: svelteParser,
      parserOptions: {
        parser: tsParser,
      },
    },
  },
];
javascript

MCP と ESLint の役割分担

ツール役割実行タイミング
ESLintコードスタイル、一般的なルール保存時、CI
svelte-autofixerSvelte 固有の問題、最新構文AI との対話時

AGENTS.md / CLAUDE.md / GEMINI.md 設定

MCP クライアントに応じて、適切な設定ファイルを使用します。

クライアント設定ファイル
汎用 AGENTS.md
Claude Code CLAUDE.md
Gemini CLI GEMINI.md

推奨プロンプト

npx sv add mcp で自動生成されるプロンプトは以下の内容です。

You are able to use the Svelte MCP server, where you have access to comprehensive Svelte 5 and SvelteKit documentation. Here's how to use the available tools effectively:

## Available MCP Tools:

### 1. list-sections

Use this FIRST to discover all available documentation sections. Returns a structured list with titles, use_cases, and paths.
When asked about Svelte or SvelteKit topics, ALWAYS use this tool at the start of the chat to find relevant sections.

### 2. get-documentation

Retrieves full documentation content for specific sections. Accepts single or multiple sections.
After calling the list-sections tool, you MUST analyze the returned documentation sections (especially the use_cases field) and then use the get-documentation tool to fetch ALL documentation sections that are relevant for the user's task.

### 3. svelte-autofixer

Analyzes Svelte code and returns issues and suggestions.
You MUST use this tool whenever writing Svelte code before sending it to the user. Keep calling it until no issues or suggestions are returned.

### 4. playground-link

Generates a Svelte Playground link with the provided code.
After completing the code, ask the user if they want a playground link. Only call this tool after user confirmation and NEVER if code was written to files in their project.
markdown
svelte-task プロンプト

MCP クライアントがプロンプト機能をサポートしている場合は、svelte-task プロンプトを使用することで、LLM に MCP サーバーの効果的な使い方を指示できます。

カスタマイズ例

プロジェクト固有のルールを追加できます。

## プロジェクト固有ルール

- Svelte 5 の Runes のみ使用(レガシー構文禁止)
- TypeScript 必須
- Tailwind CSS でスタイリング
- shadcn-svelte コンポーネントを優先使用
markdown

CI/CD 統合

チーム開発では、Pull Request 時に自動的にコード品質をチェックする CI/CD パイプラインが重要です。ESLint による静的解析と TypeScript の型チェックを組み合わせることで、レビュー前に基本的な問題を検出できます。

ダイアグラムを読み込み中...

以下の図は、PR 時の自動チェックフローを示しています。将来的には MCP の svelte-autofixer を CI/CD に統合し、AI による自動レビューも可能になる見込みです。

GitHub Actions 例

name: Svelte Code Quality

on:
  pull_request:
    paths:
      - '**.svelte'

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Install dependencies
        run: npm ci

      - name: Run ESLint
        run: npm run lint

      - name: Type check
        run: npm run check
yaml

AI レビュー統合(構想)

将来的には、CI/CD パイプラインで AI による自動レビューが可能になります。

# 将来の構想例
- name: AI Code Review
  uses: ai-review-action@v1
  with:
    mcp-server: svelte
    tools:
      - svelte-autofixer
yaml

VS Code 設定

VS Code は Svelte 開発で最も人気のあるエディタの一つです。適切な拡張機能とワークスペース設定を行うことで、シンタックスハイライト、自動補完、リアルタイムエラー検出、フォーマット機能が利用できます。

以下の設定をプロジェクトの .vscode/ ディレクトリにコミットすることで、チームメンバー全員が同じ開発環境を利用できるようになります。

推奨拡張機能

// .vscode/extensions.json
{
  "recommendations": [
    "svelte.svelte-vscode",
    "dbaeumer.vscode-eslint",
    "esbenp.prettier-vscode"
  ]
}
json

ワークスペース設定

// .vscode/settings.json
{
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "[svelte]": {
    "editor.defaultFormatter": "svelte.svelte-vscode"
  },
  "eslint.validate": ["javascript", "typescript", "svelte"],
  "svelte.enable-ts-plugin": true
}
json

トラブルシューティング

MCP が認識されない

  1. 設定ファイルの構文を確認
  2. クライアントを再起動
  3. claude mcp list で登録状態を確認

ESLint と MCP の競合

両者は補完関係にあるため、基本的に競合しません。 もし異なる指摘が出た場合は、MCP の svelte-autofixer の結果を優先してください(最新の Svelte 仕様に基づいているため)。

autofixer が動作しない

  1. Svelte ファイルの構文エラーを確認
  2. <script lang="ts"> タグが正しいか確認
  3. MCP サーバーが起動しているか確認

次のステップ

開発環境の統合が完了したら、 エコシステム で関連ツールとリソースを確認してください。

Last update at: 2026/01/09 19:09:10