servers/Review/readme.md

# Review Service (Bio-Agent)

This service generates long-form biomedical literature reviews with streaming (SSE) and MCP mounts.

## Features
- Iterative research and planning loops
- Streaming SSE responses
- MCP mounts: `/review`, `/check`
- Configurable LLM providers (OpenAI-compatible, Qianwen/DashScope)

## Requirements
- Python 3.11+
- `.env` (see `env_example.txt`)
- Optional: Docker

## Configuration
Common env keys:
- `OPENAI_BASE_URL`, `OPENAI_API_KEY`
- `QIANWEN_BASE_URL`, `QIANWEN_API_KEY`
- `SEARCH_URL` (e.g., `http://localhost:9487`)
- `LOG_DIR`, `LOG_LEVEL`, `LOG_MAX_SIZE`, `LOG_BACKUP_COUNT`, `LOG_ENABLE_CONSOLE`, `LOG_ENABLE_FILE`
- `DEBUG_MODE` (true shows `/docs`)

## Run Locally
Option A (uv):
```
cd servers/Review
uv sync
uv run uvicorn Review.main:app --host 0.0.0.0 --port 8880
```

Option B (script):
```
cd servers/Review
chmod +x run.sh
./run.sh
```

Endpoints:
- MCP: `http://localhost:8880/review`, `http://localhost:8880/check`
- Docs (if DEBUG_MODE=true): `http://localhost:8880/docs`

## API
- `GET /health` (SSE)
- `GET /review_generate?query=...` (SSE)

Example:
```
curl -N "http://localhost:8880/review_generate?query=generate+review+about+rna-seq"
```

## Docker
Build (repo root):
```
docker build -t review_mcp:local -f servers/Review/Dockerfile servers/Review
```
Run:
```
docker run --rm -p 8880:8880 --env-file .env review_mcp:local
```

Notes:
- Uses `uv` with `uv.lock` for reproducible installs.
- Pipeline may take tens of minutes; progress is streamed via SSE.