feat(serve): stdio 외 직접 Streamable HTTP MCP transport 추가 (+선택적 bearer)

.env.example

@@ -34,6 +34,11 @@ CHROMA_COLLECTION=opencrab_vectors
 # ── MCP ───────────────────────────────────────
 MCP_SERVER_NAME=opencrab
 MCP_SERVER_VERSION=0.1.0
+# HTTP transport (opencrab serve --transport http). Use 0.0.0.0 to expose
+# on a trusted network. The bearer token is provided via --auth-token-file
+# or OPENCRAB_MCP_TOKEN / OPENCRAB_MCP_TOKEN_FILE (not stored here).
+MCP_HTTP_HOST=127.0.0.1
+MCP_HTTP_PORT=8765
 
 # Logging
 LOG_LEVEL=INFO

Makefile

@@ -1,4 +1,4 @@
-.PHONY: help install dev-install up down status serve query manifest lint format test coverage seed
+.PHONY: help install dev-install status serve serve-http query manifest lint format test coverage seed
 
 PYTHON := python
 PIP    := pip
@@ -10,10 +10,9 @@ help:
 	@echo "Usage:"
 	@echo "  make install       Install package"
 	@echo "  make dev-install   Install with dev extras"
-	@echo "  make up            Start all Docker services"
-	@echo "  make down          Stop all Docker services"
 	@echo "  make status        Check store connections"
-	@echo "  make serve         Start MCP server on stdio"
+	@echo "  make serve         Start MCP server on stdio (default)"
+	@echo "  make serve-http    Start MCP server over Streamable HTTP"
 	@echo "  make manifest      Print MetaOntology grammar"
 	@echo "  make seed          Seed databases with example data"
 	@echo "  make lint          Run ruff linter"
@@ -27,19 +26,15 @@ install:
 dev-install:
 	$(PIP) install -e ".[dev]"
 
-up:
-	docker-compose up -d
-	@echo "Services starting... run 'make status' to check readiness."
-
-down:
-	docker-compose down
-
 status:
 	$(PYTHON) -m opencrab.cli status
 
 serve:
 	$(PYTHON) -m opencrab.cli serve
 
+serve-http:
+	$(PYTHON) -m opencrab.cli serve --transport http
+
 manifest:
 	$(PYTHON) -m opencrab.cli manifest