Swing MCP: AI hands for Java desktop apps — Swing and JavaFX.

Swing MCP in Claude Desktop

1. Java 21+ on your PATH.
2. Download and open swing-mcp.mcpb; click Install.
3. It appears under Settings → Extensions. Ask Claude to launch_app your application.

Full guide for Claude Desktop →

Swing MCP in Claude Code

1. Java 21+; unzip swing-mcp.mcpb for the two jars in server/.
2. Register the server (add -s user for every project):

claude mcp add swing \
  --env SWING_MCP_AGENT_JAR=/path/to/swing-mcp/server/swing-mcp-agent.jar \
  -- java -jar /path/to/swing-mcp/server/swing-mcp-server.jar

claude mcp list → swing … ✓ Connected

Full guide for Claude Code →

Swing MCP in VS Code + GitHub Copilot

1. Java 21+; unzip swing-mcp.mcpb for the two jars.
2. Create .vscode/mcp.json (or MCP: Add Server). VS Code uses servers and "type": "stdio":

{
  "servers": {
    "swing": {
      "type": "stdio",
      "command": "java",
      "args": ["-jar", "/path/to/swing-mcp/server/swing-mcp-server.jar"],
      "env": { "SWING_MCP_AGENT_JAR": "/path/to/swing-mcp/server/swing-mcp-agent.jar" }
    }
  }
}

Click Start; in Copilot Chat choose Agent mode and open the tools picker.

Full guide for VS Code + GitHub Copilot →

Swing MCP in Cursor

1. Java 21+; unzip swing-mcp.mcpb for the two jars.
2. Cursor Settings → Tools & Integrations → MCP Tools → New MCP Server opens mcp.json:

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

Green dot = connected. The agent asks before each tool call by default. Cursor caps active MCP tools (40 at the time of writing); Swing MCP exposes 39.

Full guide for Cursor →

Swing MCP in Devin Desktop (Windsurf)

1. Java 21+; unzip swing-mcp.mcpb for the two jars.
2. Settings → Cascade → MCP Servers → raw config ~/.codeium/windsurf/mcp_config.json:

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

Cognition renamed Windsurf to Devin Desktop in 2026; the config path is unchanged. Tools can be toggled per server (100 active tools max).

Full guide for Devin Desktop (Windsurf) →

Swing MCP in IntelliJ IDEA

1. Java 21+; unzip swing-mcp.mcpb for the two jars.
2. Settings → Tools → AI Assistant → Model Context Protocol (MCP) → + → STDIO, paste:

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

OK, Apply; the status icon lists the 39 tools. Start a new AI Assistant chat.

Full guide for IntelliJ IDEA →

Swing MCP in OpenAI Codex CLI

1. Java 21+; unzip swing-mcp.mcpb for the two jars.
2. Register the server (written to ~/.codex/config.toml):

codex mcp add swing \
  --env SWING_MCP_AGENT_JAR=/path/to/swing-mcp/server/swing-mcp-agent.jar \
  -- java -jar /path/to/swing-mcp/server/swing-mcp-server.jar

codex mcp list shows swing … enabled; /mcp inside a session lists the tools.

Full guide for OpenAI Codex CLI →

Swing MCP in Gemini CLI

1. Java 21+; unzip swing-mcp.mcpb for the two jars.
2. Register the server (drop -s user for the current project only):

gemini mcp add -s user swing java \
  -e SWING_MCP_AGENT_JAR=/path/to/swing-mcp/server/swing-mcp-agent.jar \
  -- -jar /path/to/swing-mcp/server/swing-mcp-server.jar

gemini mcp list → ✓ swing … Connected. Trust the folder first if it says the servers are disabled.

Full guide for Gemini CLI →