Java MCP Server

Java MCP Server

This project represents the Java MCP server variants made for the Final Year Research Project.

This server variants use either an unstructured concurrency approach or a structured concurrency approach for handling multiple threads per request.

It includes a mock repository for the file analysis, which include three folders:

• Java - Contains a section of the apache-commons-lang library
• Rust - Contains a section of the Rust Compiler
• JavaScript - Contains a section of the Facebook React source code

The full repositories can be accessed in the following links:

• Java - https://github.com/apache/commons-lang
• Rust - https://github.com/rust-lang/rust
• JavaScript - https://github.com/facebook/react/

Setup Instructions

1. Ensure Docker Desktop is installed and an MCP client (e.g. Claude) is connected.

2. Go to the project root and create the Docker image:

docker build -t java-mcp-server .

3. Open a terminal window and create a new MCP catalog file:

nano ~/.docker/mcp/catalogs/customCatalog.yaml

4. Create the YAML file with the following code

version: 2
name: custom
displayName: Custom MCP Catalog
registry:
  java-mcp-server:
    title: Java MCP Server
    description: Local Java MCP server image
    type: server
    image: java-mcp-server:latest
    ref: ""
  rust-mcp-server:
    title: Rust MCP Server
    description: Local Rust MCP server image
    type: server
    image: rust-mcp-server:latest
    ref: ""

5. Update the Docker MCP registry with our custom server images.

nano ~/.docker/mcp/registry.yaml

registry:
  java-mcp-server:
    ref: ""
  rust-mcp-server:
    ref: ""

6. Update the Claude config file with the newly created configuration files.

open -a TextEdit "/Users/pradeep/Library/Application Support/Claude/claude_desktop_config.json"

{
  "mcpServers": {
    "mcp-toolkit-gateway": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/var/run/docker.sock:/var/run/docker.sock",
        "-v",
        "/Users/{USER_NAME}/.docker/mcp:/mcp",
        "docker/mcp-gateway",
        "--catalog=/mcp/catalogs/docker-mcp.yaml",
        "--catalog=/mcp/catalogs/customCatalog.yaml",
        "--config=/mcp/config.yaml",
        "--registry=/mcp/registry.yaml",
        "--tools-config=/mcp/tools.yaml",
        "--transport=stdio"
      ]
    }
  },
  "preferences": {
    "coworkScheduledTasksEnabled": false,
    "sidebarMode": "chat",
    "coworkWebSearchEnabled": true,
    "ccdScheduledTasksEnabled": false
  }
}

7. Open Claude Desktop and view the connectors to see the new MCP servers.

8. Ensure that Grafana is connected to a Prometheus data source via http://host.docker.internal:9090

9. To do the HTTP Benchmark, run

   docker run --rm -p 9101:9101 -p 8080:8080 java-mcp-server --test 00 --mode structured
   

   or

   docker run --rm -p 9100:9100 -p 8080:8080 java-mcp-server --test 00 --mode baseline
   

   in the terminal and then configure and run

   node HTTPBenchmark
   

   in the directory of the benchmark file.