spring -bridge

Spring MCP Bridge automatically scans a Spring Boot project and exposes its REST endpoints as an MCP server. It analyzes controllers, request mappings, and models, then generates a FastAPI-based MCP server along with an MCP schema that clients (like Claude or Cursor) can use to interact with the underlying Spring API. The bridge preserves request and response models and can extract Javadoc or inline documentation to enrich tool descriptions, providing a ready-to-use interface for AI assistants to invoke your API endpoints without writing boilerplate MCP code yourself.

To use it, first generate the MCP server from your Spring project, then run the generated Python application. Once the server is running, you can access the MCP API at the configured port (default 8000) and connect your MCP client to http://localhost:8000. The MCP schema describing all endpoints is available at http://localhost:8000/.well-known/mcp-schema.json, enabling client tooling to discover available methods, parameters, and return types.

Prerequisites:

• Python 3.8 or newer
• Java Spring Boot project to scan
• git

Install and run:

1. Clone the repository and navigate to the generated MCP bridge project (the one that contains main.py after running the scanner).

git clone https://github.com/brunosantos/spring-mcp-bridge.git
cd spring-mcp-bridge

2. Ensure you have the Spring Boot project you want to bridge accessible. The bridge scans a local path to your Spring project and outputs an MCP server in a directory such as mcp_server with a main.py file.

# Example (adjust to your environment after running the scanner):
python spring_mcp_bridge.py --project /path/to/your/spring-project --output ./mcp_server --name MyAPI

3. Install Python dependencies for the generated MCP server and run it:

cd mcp_server
pip install -r requirements.txt
python main.py

4. With the server running, connect an MCP client to http://localhost:8000 and view the documentation at http://localhost:8000/docs. The MCP schema will be available at http://localhost:8000/.well-known/mcp-schema.json.

Tips and considerations:

• The bridge does not implement authentication by default. If your Spring API requires auth, you’ll need to modify the generated handler code or add appropriate headers/tokens.
• The generated MCP server defaults to port 8000. If needed, adjust configuration in main.py (e.g., FastAPI setup) to bind to a different port.
• The SPRING_BASE_URL variable sets the base URL of your Spring Boot application (default http://localhost:8080). Update it to match your deployment.
• The MCP schema and documentation are generated automatically; ensure your Spring project is fully scanned and accessible for accurate mappings.
• If the Spring project uses complex types, review the JSON Schema conversions in the generated server to confirm compatibility with your MCP clients.