MCP Codex Server

mcp-server

Spring Boot 3 / Java 17 MCP-Server, der ein Code-Tool (explain-code) via Spring AI MCP Annotations exponiert und intern die OpenAI-Integration (ChatClient) nutzt.

Import in IntelliJ

1. ZIP entpacken.
2. In IntelliJ: File → Open... und den Ordner mcp-server auswählen.
3. IntelliJ erkennt das Gradle-Projekt (Kotlin DSL) automatisch.
4. Als Project SDK JDK 17 wählen.

Build & Start

./gradlew bootRun

MCP-Server wird als .jar gebaut:

• ./build/libs/mcp-server-0.0.1-SNAPSHOT.jar

Tools

• explain-code(language?, code) – gibt eine deutsche Schritt-für-Schritt-Erklärung.

Tools werden via @McpTool registriert und vom Annotation Scanner automatisch gefunden (spring.ai.mcp.server.annotation-scanner.enabled=true).

Einbinden in Intellij

In Tools > AI Assistant -> Settings -> Tools -> AI Assistent -> MPC Konfigiration (JSON) wie folgt anlegen:

{
    "mcpServers": {
        "local-mcp": {
            "command": "java",
            "args": [
            "-Dspring.ai.mcp.server.stdio:true",
            "-Dspring.main.web-application-type:none",
            "-jar",
            "/Users/NAME/PATH/mcp-server/build/libs/mcp-server-0.0.1-SNAPSHOT.jar"
            ],
            "env": {
                "SPRING_AI_OPENAI_API_KEY": "DEIN_API_KEY"
            }
        }
    }
}

Logs

Die logs landen dann im Intellij Log Verzeichnis: Bsp osx: /Users/NAME/Library/Logs/IntelliJIdea20xx/mcp/local-mcp.log Bsp linux: /home/NAME/.cache/JetBrains/IntelliJIdea20xx.2/log/mcp/local-mcp.log