mirror of
https://github.com/nagisa77/OpenIsle.git
synced 2026-02-26 16:10:49 +08:00
35 lines
1.4 KiB
Markdown
35 lines
1.4 KiB
Markdown
# 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
|
||
|
||
```bash
|
||
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.
|