A Model Context Protocol (MCP) server for analyzing and manipulating Shockwave Flash (SWF) files using JPEXS Free Flash Decompiler (FFDec).

TL;DR: Let AI assistants (Claude, GitHub Copilot, etc.) read, modify, and patch SWF files through natural language commands.

# 1. Build the image
podman build -t ffdec-mcp-server:latest .

# 2. Add to your MCP client config (see Installation for details)

npx -y @smithery/cli install @Xeleron/ffdec-mcp --client claude

The Dockerfile handles all FFDec library dependencies automatically.

podman build -t ffdec-mcp-server:latest .

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "ffdec": {
      "command": "podman",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/absolute/path/to/your/swfs:/swfs:rw",
        "ffdec-mcp-server:latest"
      ]
    }
  }
}

Note: Replace /absolute/path/to/your/swfs with your actual local directory.

1. Clone the repository:

   git clone https://github.com/Xeleron/ffdec-mcp.git
   cd ffdec-mcp

2. Install FFDec library:

   mvn install:install-file \
     -Dfile=/path/to/ffdec_lib.jar \
     -DgroupId=com.jpexs \
     -DartifactId=ffdec_lib \
     -Dversion=1.0.0 \
     -Dpackaging=jar

3. Build and Configure:

   mvn clean package

   Point your MCP client to the resulting run.sh (ensure it is executable via chmod +x run.sh).

The server exposes 40+ tools. Use tools/list at runtime for full technical definitions.

User: "Open game.swf and show me what classes it contains" AI: Uses open_swf, then list_classes.

User: "Change the player's max health from 100 to 200 in the Player class" AI: Searches for the constant, uses edit_constants or patch_method, then save_swf.

Licensed under the Apache License 2.0.