andraschi/gimp-mcpがClaude Desktopで認識されない → manifest.json書いて手動で拡張機能インストールしたら解決した話

GIMPをMCP経由でClaude（Winデスクトップ版）から操作したいので、

↑というのを導入したのですが、claude_desktop_config.json に書いてもまったく認識されず四苦八苦しました。

最初に結論から

結論だけ言うと、拡張機能(Extensions)として入れたら問題なく認識されたという話です。

TL;DR

• Extensions対応のClaude Desktopでは、claude_desktop_config.json の mcpServers が読まれないことがある
• 判別法：%LOCALAPPDATA%\Claude\Logs\mcp-server-<名前>.log が作られていない＝起動すら試みていない
• 解決：manifest.json を書いて「パッケージ化されていない拡張機能のインストール」から読み込む
• ついでの罠：GIMPは3.2以上必須／uv syncのcffiビルド失敗は**--python 3.12で回避／ポート9877は生TCPなのでブラウザでは確認不可、Test-NetConnectionで確認**

環境

• Windows 11
• Claude Desktop（拡張機能=Extensions対応版）
• GIMP 3.2.4
• gimp-mcp（要 uv）

ハマったこと

claude_desktop_config.json の mcpServers に gimp を追記して再起動しても、Claude側にGIMPのツールが出てこない。何度書き直しても変化なし。

原因

ログを見て確定しました。

Get-ChildItem "$env:LOCALAPPDATA\Claude\Logs\mcp-server-*.log" | Select Name,LastWriteTime

既存のMCP（BlenderやUnity）のログはあるのに、mcp-server-gimp.log が一切作られていない＝アプリがconfigのgimpエントリを起動すらしていない。
さらに、動いている既存MCPは全て ...\Claude\Claude Extensions\ 配下にありました。

つまり、このClaude Desktopは claude_desktop_config.json を使わず、拡張機能(Extensions)としてMCPを管理している。configをいくら直しても無駄でした。

解決策：manifest.json を書いて「パッケージ化されていない拡張機能」として入れる

1. 事前準備

• GIMPは 3.2以上（必須）
• gimp-mcp を clone して uv sync
  • cffi のビルドで Microsoft Visual C++ 14.0 or greater is required が出たら、Pythonが新しすぎ（3.14等でwheelが無く、ソースビルドに落ちる）。Python 3.12を指定すれば回避できる：

    uv python install 3.12
    uv sync --python 3.12

2. manifest.json を作る

gimp-mcp リポジトリ直下（例：C:\Users\<ユーザー名>\gimp-mcp\manifest.json）に配置。${__dirname} がそのフォルダ自身を指すのでパスを書かずに済みます。

{
  "manifest_version": "0.3",
  "name": "gimp-mcp",
  "display_name": "GIMP",
  "version": "0.1.0",
  "description": "Bridges Claude to a running GIMP via the gimp-mcp stdio server.",
  "author": { "name": "maorcc", "url": "https://github.com/maorcc/gimp-mcp" },
  "server": {
    "type": "binary",
    "entry_point": "gimp_mcp_server.py",
    "mcp_config": {
      "command": "uv",
      "args": [
        "run",
        "--python", "3.12",
        "--directory", "${__dirname}",
        "gimp_mcp_server.py"
      ]
    }
  },
  "tools_generated": true,
  "compatibility": { "platforms": ["win32"] },
  "keywords": ["gimp", "image", "mcp"],
  "license": "MIT"
}

3. Claude Desktopに拡張として読み込む

設定 → 拡張機能 →（詳細設定）→「パッケージ化されていない拡張機能のインストール」 から、gimp-mcp フォルダを指定。読み込んだらClaude Desktopを完全再起動。

4. GIMP側のサーバーを起動

GIMPを起動 → 何か画像を開く → Tools ▸ MCP ▸ Start MCP Server（localhost:9877 で待受）。

5. 疎通確認

localhost:9877 は生のTCPソケットなので、ブラウザでURLを叩いてもタイムアウトします（＝落ちてる証拠にはならない）。正しくはこれ：

Test-NetConnection -ComputerName 127.0.0.1 -Port 9877

TcpTestSucceeded : True ならGIMP側はOK。あとはClaude側にGIMPのツールが出ていれば成功です。

まとめ

• Extensions対応のClaude Desktopでは、claude_desktop_config.json の mcpServers は読まれないことがある
• mcp-server-<name>.log が作られているかどうかが、起動を試みたかの判断材料になる
• 生のstdio系MCPも manifest.json を書けば「パッケージ化されていない拡張機能」として導入できる

同じ沼にハマった人の助けになれば。