Skip to content
MCP server

Swing MCP

Let an AI assistant operate Java Swing and JavaFX desktop apps with no API needed

Runs locallyStatus and history
Pricing
Open source
Platforms
Windows, macOS, Linux
Runs
Locally
Version
1.4.0
Listing updated
3 days ago

About Swing MCP

Swing MCP is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

A lot of business software is Java desktop software with no API and no web UI, such as ERP clients, point-of-sale and lab systems. Swing MCP gives an assistant a way in without changing the application. A Java agent is loaded into the target JVM, either at launch or by attaching to a running process id, and the 39 tools run on the toolkit's own UI thread, so it behaves like a fast, patient user.

Instead of reading pixels, the assistant gets a structured snapshot of the component tree with stable ids for every button, field, table, tree, menu and dialog. It can click, type, fill forms, select table cells and tree nodes, drive menus, read whole tables as data, take screenshots and wait for UI conditions. Modal dialogs are detected and answered rather than blocking the session, and several apps can run in parallel sessions. JavaFX is supported since version 1.3.0, and mixed apps work.

Safety defaults: the agent listens on loopback only with a per-session token, evaluate_java is off unless enabled, and tools carry read-only or destructive annotations. It needs Java 21 or newer and installs as an .mcpb file in Claude Desktop or via a JAR in other clients. The project is open source and its maker also builds custom connectors.

Install

Run in a terminal

claude mcp add swing-mcp -- npx -y https://github.com/crosstech-solutions-bv/swing-mcp/releases/download/V1.4.0/swing-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "swing-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/crosstech-solutions-bv/swing-mcp/releases/download/V1.4.0/swing-mcp.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "swing-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/crosstech-solutions-bv/swing-mcp/releases/download/V1.4.0/swing-mcp.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "swing-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/crosstech-solutions-bv/swing-mcp/releases/download/V1.4.0/swing-mcp.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "swing-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/crosstech-solutions-bv/swing-mcp/releases/download/V1.4.0/swing-mcp.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "swing-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/crosstech-solutions-bv/swing-mcp/releases/download/V1.4.0/swing-mcp.mcpb"
      ]
    }
  }
}

Tools this server provides (9)

Taken from the project documentation; the running server may differ.

launch_app
Starts a Java app with the agent preloaded.
attach_to_app
Attaches to a running JVM by process id.
take_snapshot
Returns the UI as a component tree.
click
Clicks a component.
fill
Fills a text field or similar input.
wait_for
Waits for a UI condition.
stop_app
Stops a launched app.
close_window
Closes a window.
evaluate_java
Runs code in the target JVM, off by default.

What it does

Component tree snapshot
Returns every control with a stable id instead of pixel guessing.
Full UI actions
Click, type, fill fields, pick combo options, drive menus and drag in Swing.
Structured data reads
Reads whole tables, lists and trees plus screenshots.
Swing and JavaFX
One tool set drives either toolkit, or both in one app.
Dialog handling
Detects and answers modal dialogs and waits for UI conditions.
Locked-down defaults
Loopback-only agent, session token and evaluate_java off by default.

Good for

  • Automate repetitive entry in an old in-house Java client
  • Read a legacy table's contents into structured data
  • Test a Swing or JavaFX app's flows through an assistant
  • Drive a point-of-sale or lab system with no API

Pricing

Open source

Open source; custom connectors offered by the maker

Prices change. Check crosstech.solutions before you buy.

Swing MCP FAQ

What do I need installed?

Java 21 or newer on your PATH; Claude Desktop installs the swing-mcp.mcpb file as an extension.

Does it work with JavaFX?

Yes, since version 1.3.0, and with apps that mix both toolkits.

Can it run arbitrary code in my app?

Only if you switch on evaluate_java; it is off by default.

Which clients are documented?

Claude Desktop, Claude Code, VS Code with Copilot, Cursor, Windsurf, IntelliJ IDEA, Codex CLI and Gemini CLI.

Is Swing MCP free?

Yes. Swing MCP is open source, so you can use and self-host it for free.

How do I add Swing MCP to Claude Code?

Run this command in your terminal: claude mcp add swing-mcp -- npx -y https://github.com/crosstech-solutions-bv/swing-mcp/releases/download/V1.4.0/swing-mcp.mcpb

What are the best alternatives to Swing MCP?

The closest alternatives to Swing MCP are REA, Browser Use, Scrapling MCP Server, Codebase Memory and GitHub.

Alternatives to Swing MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  3. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  4. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  5. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  6. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools