COMPLETE_SETUP_GUIDE.md•3.4 kB
# Aseprite MCP - Claude Desktop完全セットアップガイド
## 現在の状況
- ✅ Aseprite本体のソースコード（要ビルド）
- ✅ Aseprite MCPプロジェクト
- ✅ Claude Desktop（MCP対応）
- ❌ Python（未インストール）
- ❌ Aseprite（未ビルド）
## セットアップ手順
### ステップ1: Pythonのインストール
1. [Python公式サイト](https://www.python.org/downloads/)から最新のPython 3.13をダウンロード
2. インストール時に「Add Python to PATH」にチェック
3. インストール完了後、新しいコマンドプロンプトで確認：
```cmd
python --version
```
### ステップ2: Aseprite MCPの依存関係インストール
```cmd
cd C:\Users\moroya.sakamoto\Desktop\aseprite-mcp
pip install -r requirements.txt
```
### ステップ3: Asepriteのビルド
1. Visual Studio Community 2022をインストール
2. CMakeをインストール
3. 以下のコマンドを実行：
```cmd
cd C:\Users\moroya.sakamoto\Desktop
clone-aseprite.bat
build-aseprite.bat
```
### ステップ4: Claude Desktopの設定
1. 以下の内容で設定ファイルを更新：
```json
{
"serverConfig": {
"command": "cmd.exe",
"args": [
"/c"
]
},
"mcpServers": {
"desktop-commander": {
"command": "npx.cmd",
"args": [
"@wonderwhy-er/desktop-commander@latest"
]
},
"playwright": {
"command": "npx",
"args": [
"@playwright/mcp@latest"
]
},
"aseprite": {
"command": "python",
"args": [
"-m",
"aseprite_mcp"
],
"cwd": "C:\\Users\\moroya.sakamoto\\Desktop\\aseprite-mcp",
"env": {
"ASEPRITE_PATH": "C:\\Users\\moroya.sakamoto\\Desktop\\aseprite\\build\\bin\\aseprite.exe",
"PYTHONPATH": "C:\\Users\\moroya.sakamoto\\Desktop\\aseprite-mcp"
}
}
}
}
```
2. ファイルを保存：
```cmd
copy C:\Users\moroya.sakamoto\Desktop\aseprite-mcp\claude_desktop_config_with_aseprite.json C:\Users\moroya.sakamoto\AppData\Roaming\Claude\claude_desktop_config.json
```
3. Claude Desktopを再起動
### ステップ5: 動作確認
Claude Desktopで以下のコマンドが使用できるようになります：
- `create_canvas`: 新規キャンバス作成
- `draw_pixels`: ピクセル描画
- `draw_line`: 線描画
- `draw_rectangle`: 矩形描画
- `add_layer`: レイヤー追加
- `export_to_png`: PNG出力
## 代替案：既存のAsepriteを使用
もし既にAsepriteがインストールされている場合（Steam版など）：
1. `.env`ファイルまたは設定のASEPRITE_PATHを更新：
```
ASEPRITE_PATH=C:\Program Files (x86)\Steam\steamapps\common\Aseprite\Aseprite.exe
```
2. Claude Desktopの設定も同様に更新
## トラブルシューティング
### Python関連
- Microsoft StoreのPythonは使用しない（パス問題が発生しやすい）
- 公式サイトからインストーラーでインストール推奨
### MCP接続エラー
- Claude Desktopのログを確認
- Pythonスクリプトが正しく起動するか単体でテスト：
```cmd
cd C:\Users\moroya.sakamoto\Desktop\aseprite-mcp
python -m aseprite_mcp
```
### Asepriteが見つからない
- パスに日本語が含まれていないか確認
- 実行ファイルが存在するか確認