OpenIsle MCP Service
This package hosts a lightweight Python service that exposes OpenIsle search capabilities through a Model Context Protocol (MCP) compatible HTTP interface. It currently forwards search requests to the main Spring Boot backend and returns the aggregated results. The service is intentionally simple so we can iterate quickly and extend it with additional tools (for example, post creation) in future updates.
Local development
pip install -e ./mcp
openisle-mcp
By default the server listens on port 9090 and expects the Spring Boot backend
at http://localhost:8080. Configure the behaviour with the following
environment variables:
MCP_PORT– HTTP port the MCP service should listen on (default:9090).MCP_HOST– Bind host for the HTTP server (default:0.0.0.0).MCP_BACKEND_BASE_URL– Base URL of the Spring Boot backend that provides the search endpoints (default:http://springboot:8080).MCP_CONNECT_TIMEOUT– Connection timeout (seconds) when calling the backend (default:5).MCP_READ_TIMEOUT– Read timeout (seconds) when calling the backend (default:10).
Docker
The repository contains a Dockerfile that builds a slim Python image running the
service with uvicorn. The compose configuration wires the container into the
existing OpenIsle stack so that deployments automatically start the MCP service.