Jakarta Migration

Jakarta Migration MCP Server

A Model Context Protocol (MCP) server that provides AI coding assistants with specialized tools for analyzing and migrating Java applications from Java EE 8 (javax.*) to Jakarta EE 9+ (jakarta.*).

🚀 Quick Start

Run locally (STDIO)

Prerequisites: Java 21+ and Node.js 18+

# Install via npm (one-time)
npm install -g @jakarta-migration/mcp-server

# Or use with npx (no installation)
npx -y @jakarta-migration/mcp-server

See Local Setup (STDIO) below for client configuration.

🖥️ IntelliJ IDEA Plugin

A native IntelliJ IDEA plugin is also available for users who prefer an IDE-integrated experience:

Download

Get it from JetBrains Marketplace →

Features

• Migration Analysis - Analyze Java projects for Jakarta EE migration readiness
• Dependency Graph Visualization - Visualize module dependencies with multiple layout options (hierarchical, force-directed, circular, tree)
• MCP Server Integration - Automatically connects to Jakarta Migration MCP server
• AI Assistant Tools - AI Assistant integration for intelligent migration suggestions
• Tool Window - Dedicated Jakarta Migration tool window for easy access
• Refactor Tab - Apply and manage OpenRewrite refactorings
• Runtime Verification - Test migrated applications at runtime

Installation

1. Install via IntelliJ IDEA:
   • Open Settings (Ctrl+Alt+S or Cmd+,)
   • Go to Plugins
   • Search for Jakarta Migration
   • Click Install
2. Restart IntelliJ IDEA

Usage

1. Open a Java project
2. Go to Tools → Jakarta Migration or use Ctrl+Shift+J
3. The Jakarta Migration tool window will open
4. Click Analyze Project to start analysis
5. View results in the dependency graph and analysis panel

AI Assistant Integration

If you have IntelliJ AI Assistant installed:

1. The plugin automatically registers MCP tools with AI Assistant
2. Ask AI Assistant: "Analyze my project for Jakarta migration"
3. AI Assistant will use the MCP tools to analyze your project

Requirements

• IntelliJ IDEA 2023.3.4 or later
• Java 17 or later
• Optional: AI Assistant plugin for AI features

📋 What It Does

The Jakarta Migration MCP Server enables your AI coding assistant to:

• 🔍 Analyze Jakarta Readiness - Assess Java projects for migration readiness with detailed dependency analysis
• 🚫 Detect Blockers - Identify dependencies and code patterns that prevent Jakarta migration
• 📦 Recommend Versions - Suggest Jakarta-compatible versions for existing dependencies
• 📋 Create Migration Plans - Generate comprehensive, phased migration plans with risk assessment
• 📊 Analyze Migration Impact - Comprehensive impact analysis combining dependency analysis and source code scanning
• ✅ Verify Runtime - Test migrated applications to ensure they run correctly after migration

The Problem It Solves

Migrating from Java EE 8 (javax.*) to Jakarta EE 9+ (jakarta.*) is complex because:

• Dependency Hell: Many libraries haven't migrated, creating transitive conflicts
• Binary Incompatibility: Compiled JARs may reference javax.* internally
• Hidden Dependencies: javax.* usage in XML configs, annotations, and dynamic loading
• Risk Assessment: Need to understand migration impact before starting

This MCP server provides AI assistants with the specialized knowledge and tools to navigate these challenges effectively.

🔒 Security & Privacy

Your code and project data are handled with the utmost care. We understand that Java developers working with enterprise codebases need complete confidence in the security and privacy of their intellectual property.

Stateless Architecture

✅ No Data Persistence - The service is completely stateless. Your project files, source code, and analysis results are never stored, logged, or persisted on our servers.

✅ No Data Collection - We don't collect, track, or analyze your code. Each request is processed independently with no memory of previous requests.

✅ Local Execution Option - For maximum privacy, you can run the entire service locally using the Local Setup option. Your code never leaves your machine.

Privacy Guarantees

• Zero Code Storage: Project files are only read during analysis and immediately discarded
• No Telemetry: No usage tracking, analytics, or code scanning for any purpose other than migration analysis
• Open Source: The core service is open source, so you can audit exactly what it does
• Enterprise Ready: Safe for use with proprietary and sensitive codebases

Local Service

When running locally via STDIO:

• 100% Local - Everything runs on your machine
• No Network Calls - No external requests are made
• Complete Control - You have full visibility and control over the process

For maximum security and privacy, we recommend using the local STDIO setup for sensitive projects.

🔧 Setup Instructions

Local Setup (STDIO)

For local development, use STDIO transport which works with Cursor, Claude Code, and Antigravity. This is the recommended approach for maximum privacy and performance.

Prerequisites

• Java 21+ - Download from Adoptium
  • Verify installation: java -version
  • Should show Java 21 or higher
• Node.js 18+ - Download from nodejs.org
  • Verify installation: node --version
  • Should show v18.0.0 or higher

Installation Methods

Option 1: Global Install (Recommended)

Install the package globally for system-wide access:

npm install -g @jakarta-migration/mcp-server

After installation:

• The JAR file will be automatically downloaded from GitHub releases on first use
• JAR is cached in your home directory for faster subsequent runs
• You can use the command directly: jakarta-migration-mcp

Option 2: npx (No Installation)

Use npx to run without installing:

npx -y @jakarta-migration/mcp-server

The -y flag automatically accepts the package download. The JAR will be downloaded and cached on first use.

Option 3: Local Development Build

If you're building from source or want to use a local JAR:

# Build the JAR
./gradlew bootJar

# Set environment variable to use local JAR
export JAKARTA_MCP_JAR_PATH=/path/to/build/libs/jakarta-migration-mcp-1.0.0-SNAPSHOT.jar

# Run via npm wrapper
npx -y @jakarta-migration/mcp-server

Windows (PowerShell):

# Build the JAR
.\gradlew.bat bootJar

# Set environment variable
$env:JAKARTA_MCP_JAR_PATH = "E:\Source\JakartaMigrationMCP\build\libs\jakarta-migration-mcp-1.0.0-SNAPSHOT.jar"

# Run via npm wrapper
npx -y @jakarta-migration/mcp-server

How the npm Package Works

The npm package is a lightweight Node.js wrapper that:

1. Downloads the JAR from GitHub releases (if not already cached)
2. Caches the JAR in your home directory:
   • Windows: %USERPROFILE%\AppData\.cache\jakarta-migration-mcp\
   • Linux/macOS: ~/.cache/jakarta-migration-mcp/
3. Starts the Java process with correct MCP arguments
4. Handles stdio communication for MCP protocol

Pre-download the JAR:

You can pre-download the JAR without starting the server:

npx -y @jakarta-migration/mcp-server --download-only

This is useful for:

• Testing the download process
• Pre-caching the JAR before first use
• Verifying network connectivity

Verify Installation:

After installing, verify everything works:

# Test the wrapper can find Java and download JAR
npx -y @jakarta-migration/mcp-server --download-only

# Check if command is available (if installed globally)
jakarta-migration-mcp --download-only

You should see:

• Java version detection
• JAR download or cache confirmation
• No errors

Optional configuration

To use a custom JAR path or override transport, see NPM Installation Configuration.

Cursor IDE

1. Open Cursor Settings (Ctrl+, or Cmd+,)
2. Navigate to Features → MCP
3. Add configuration:

Windows:

{
  "mcpServers": {
    "jakarta-migration": {
      "command": "npx",
      "args": ["-y", "@jakarta-migration/mcp-server"]
    }
  }
}

Mac/Linux:

{
  "mcpServers": {
    "jakarta-migration": {
      "command": "npx",
      "args": ["-y", "@jakarta-migration/mcp-server"]
    }
  }
}

4. Restart Cursor completely

Claude Code (VS Code Extension)

1. Open VS Code Settings
2. Navigate to Claude Code → MCP Settings
3. Add the same configuration as Cursor
4. Restart VS Code

Antigravity

1. Open Antigravity Settings
2. Navigate to MCP Configuration
3. Add:

{
  "name": "jakarta-migration",
  "command": "npx",
  "args": ["-y", "@jakarta-migration/mcp-server"]
}

Alternative: Run from JAR Directly

If you've built the project locally and want to bypass the npm wrapper:

Windows:

{
  "mcpServers": {
    "jakarta-migration": {
      "command": "java",
      "args": [
        "-jar",
        "C:\\path\\to\\jakarta-migration-mcp-1.0.0-SNAPSHOT.jar",
        "--spring.profiles.active=mcp-stdio",
        "--spring.ai.mcp.server.transport=stdio",
        "--spring.main.web-application-type=none"
      ]
    }
  }
}

Mac/Linux:

{
  "mcpServers": {
    "jakarta-migration": {
      "command": "java",
      "args": [
        "-jar",
        "/path/to/jakarta-migration-mcp-1.0.0-SNAPSHOT.jar",
        "--spring.profiles.active=mcp-stdio",
        "--spring.ai.mcp.serve

---

*README truncated. [View full README on GitHub](https://github.com/adrianmikula/jakartamigrationmcp).*