MCP Selenium server in Java

This folder contains a Java implementation of a basic Model Context Protocol (MCP) server. This server provides a set of tools for an AI agent to control a web browser using Selenium. This MCP server exposes the following tools:

• open_browser: Launches a new browser instance (e.g., Chrome, Firefox).
• navigate_url: Navigates the open browser to a specified URL.
• get_browser_text: Retrieves the visible text content of the current page.
• close_browser: Closes the current browser instance.

Prerequisites

• Node.js
• A local browser (e.g., Chrome, Firefox)

1. Build the project:

Maven:

mvn clean package

Gradle:

gradle clean build

2. Run the server:

Maven build:

java -jar target/mcp-java-sdk-1.0.0.jar

Gradle build:

java -jar build/libs/mcp-java-sdk-1.0.0.jar

3. Alternatively, you can debug the MCP server using the MCP Inspector:

Maven build:

npx @modelcontextprotocol/inspector java -jar target/mcp-java-sdk-1.0.0.jar

Gradle build:

npx @modelcontextprotocol/inspector java -jar build/libs/mcp-java-sdk-1.0.0.jar

Output

The server communicates via standard input/output (stdio) and is intended to be used as an MCP server by an AI client.

If you use the MCP inspector for debugging, once connected, it will display the available tools. You can now use its user interface to execute these tools.