mcp-swing-17

mcp-swing-17

Swing および JavaFX デスクトップアプリケーションを自動化する MCP サーバーと Java エージェントです。 Java 17 向けに構築されています。Swing MCP のフォークです。

• バージョン：1.5.0-java17
• 上流コミット：abfacfa
• ライセンス：MIT（LICENSE を参照）
• 使用ガイド：USAGE.md

目次

dist/mcp-swing-17-server.jar    MCP server (stdio)
dist/mcp-swing-17-agent.jar     Java agent loaded into the target JVM
dist/*.mcpb                      MCPB bundle for one-click clients
build.ps1                       Windows build (JDK 17)
build.sh                        Linux/macOS build
mcp-swing-17-server/            server sources
mcp-swing-17-agent/             agent sources
mcp-swing-17-common/            shared classes

ビルド

powershell -NoProfile -ExecutionPolicy Bypass -File build.ps1

JDK 17 が必要です。初回の使用時に Maven 3.9.9 が .build/ にダウンロードされます。

Linux/macOS の場合：

./build.sh

または：

mvn -s maven-settings.xml -DskipTests package

実行

SWING_MCP_AGENT_JAR=<path>/dist/mcp-swing-17-agent.jar
java -jar <path>/dist/mcp-swing-17-server.jar

サーバーは stdio を使用し、通常は MCP クライアントによって起動されます。エージェントは attach_to_app を通じて、PID で実行中の Java アプリケーションにアタッチします。

{
  "mcpServers": {
    "mcp-swing-17": {
      "command": "java",
      "args": ["-jar", "<path>/dist/mcp-swing-17-server.jar"],
      "env": {
        "SWING_MCP_AGENT_JAR": "<path>/dist/mcp-swing-17-agent.jar"
      }
    }
  }
}

上流版との違い

1. Java 21 ではなく Java 17 を使用します。仮想スレッドは通常のエグゼキューターに置き換えられています。
2. Java 17 と互換性のない JMenu instanceof JMenuItem パターンを削除しました。
3. List.getFirst() を get(0) に置き換えました。
4. 対象アプリケーションの Jackson によってシャドーされないよう、エージェントの Jackson パッケージを移動しました。
5. java.version=17、JavaFX 17。
6. 実マウスによる robot 入力は、デフォルトで無効になっています。
7. windowIndex が明示的に渡されない限り、close_window はフォーカスされているダイアログのみを閉じます。

セキュリティ

• エージェントはループバックのみでリッスンします。
• evaluate_java は無効のままにしてください。
• 開発・テスト用ツールとして使用してください。
• エージェントのポートやレスポンスファイルのトークンを外部に公開しないでください。