Skip to content

Evenfire is an intelligence layer platform for running LLM agents that take real actions, on your infrastructure

TypeScript

fix(dev-mode): make single-service dev mode tooling work as documented

Jose Gabriel Ramirez Encinas8f04d008a127
diff --git a/channel-reader/README.md b/channel-reader/README.md
index 01278221f..960f8f490 100644
--- a/channel-reader/README.md
+++ b/channel-reader/README.md
@@ -163,7 +163,12 @@ npm install
npm run build
export CLERUM_DEV_MODE=true
-export CLERUM_CHANNEL='{"hostRef":"dev","telegram":[{"channelId":"test","chatType":"private","userIds":["123"]}]}'
+# Must match the mcp-host Host name (mcp-host dev mode defaults to dev-host).
+# channel-reader's own dev default is "dev", which mcp-host rejects with 403.
+export CLERUM_HOST_REF=dev-host
+# Dev mode defaults to http://localhost:8080; set this if mcp-host runs elsewhere.
+export CLERUM_MCP_HOST_URL=http://localhost:8080
+export CLERUM_CHANNEL='{"hostRef":"dev-host","telegram":[{"channelId":"test","chatType":"private","userIds":["123"]}]}'
export CLERUM_TELEGRAM_BOT_TOKEN="your-token"
npm start
```
@@ -186,10 +191,13 @@ For local iteration, use dev mode above.
# Build image
docker build -t clerum/channel-reader:latest .
-# Run in dev mode
+# Run in dev mode against an mcp-host on the Docker host's port 8080
docker run --rm \
+ --add-host=host.docker.internal:host-gateway \
-e CLERUM_DEV_MODE=true \
- -e CLERUM_CHANNEL='{"hostRef":"dev","telegram":[{"channelId":"test","chatType":"private","userIds":["123"]}]}' \
+ -e CLERUM_HOST_REF=dev-host \
+ -e CLERUM_MCP_HOST_URL=http://host.docker.internal:8080 \
+ -e CLERUM_CHANNEL='{"hostRef":"dev-host","telegram":[{"channelId":"test","chatType":"private","userIds":["123"]}]}' \
-e CLERUM_TELEGRAM_BOT_TOKEN="your-token" \
clerum/channel-reader:latest
```
diff --git a/channel-reader/package-lock.json b/channel-reader/package-lock.json
index 1c9eee879..26d79a923 100644
--- a/channel-reader/package-lock.json
+++ b/channel-reader/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-channel-reader",
- "version": "0.1.105",
+ "version": "0.1.106",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-channel-reader",
- "version": "0.1.105",
+ "version": "0.1.106",
"license": "SEE LICENSE IN LICENSE",
"dependencies": {
"@kubernetes/client-node": "^1.0.0",
diff --git a/channel-reader/package.json b/channel-reader/package.json
index d1dcd22a4..14b79bbf4 100644
--- a/channel-reader/package.json
+++ b/channel-reader/package.json
@@ -1,6 +1,6 @@
{
"name": "clerum-channel-reader",
- "version": "0.1.105",
+ "version": "0.1.106",
"description": "Watches CommunicationChannel CRDs and fetches messages from Telegram, Email, and Slack",
"main": "dist/main.js",
"engines": {
diff --git a/docker-compose.yml b/docker-compose.yml
index f6c5189e3..c1dc12c64 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,20 +1,24 @@
services:
mcp-host:
+ # Build context is the repo root: mcp-host/Dockerfile COPYs the shared
+ # packages/ it links via file: dependencies.
build:
- context: ./mcp-host
- dockerfile: Dockerfile
+ context: .
+ dockerfile: mcp-host/Dockerfile
environment:
- CLERUM_DEV_MODE: "true"
- CLERUM_ENABLE_AUTH: "false"
+ CLERUM_DEV_MODE: 'true'
+ CLERUM_ENABLE_AUTH: 'false'
CLERUM_MODEL_PROVIDER: ${CLERUM_MODEL_PROVIDER:-openai}
OPENAI_API_KEY: ${OPENAI_API_KEY:-}
CLAUDE_API_KEY: ${CLAUDE_API_KEY:-}
ZAI_API_KEY: ${ZAI_API_KEY:-}
BAILIAN_API_KEY: ${BAILIAN_API_KEY:-}
+ # Dev mode runs with auth off and trusts the edge headers, so publish the
+ # port on loopback only. Never expose it on a reachable interface.
ports:
- - "8080:8080"
+ - '127.0.0.1:8080:8080'
healthcheck:
- test: ["CMD", "wget", "-qO-", "http://localhost:8080/v1/runtime/health"]
+ test: ['CMD', 'wget', '-qO-', 'http://localhost:8080/v1/runtime/health']
interval: 10s
timeout: 5s
retries: 5
@@ -31,7 +35,7 @@ services:
mcp-host:
condition: service_healthy
environment:
- CLERUM_DEV_MODE: "true"
+ CLERUM_DEV_MODE: 'true'
CLERUM_HOST_REF: dev-host
CLERUM_MCP_HOST_URL: http://mcp-host:8080
# Replace telegram channel/user IDs to match your bot setup.
diff --git a/mcp-host/Makefile b/mcp-host/Makefile
index 9cccf655f..2062b67a3 100644
--- a/mcp-host/Makefile
+++ b/mcp-host/Makefile
@@ -18,16 +18,22 @@ build: install
clean:
rm -rf dist node_modules
+# Dev mode runs with JWT auth off (CLERUM_ENABLE_AUTH=false). With auth on,
+# mcp-host refuses to start without CLERUM_AUTH_JWT_PUBLIC_KEY. Only run these
+# targets on a machine and network you control.
+
# Run in development mode with OpenAI (uses OPENAI_API_KEY from env)
# Example: OPENAI_API_KEY=sk-xxx make dev
dev: build
CLERUM_DEV_MODE=true \
+ CLERUM_ENABLE_AUTH=false \
npm start
# Run in dev mode with Claude (uses CLAUDE_API_KEY from env)
# Example: CLAUDE_API_KEY=sk-ant-xxx make dev-claude
dev-claude: build
CLERUM_DEV_MODE=true \
+ CLERUM_ENABLE_AUTH=false \
CLERUM_MODEL_PROVIDER=claude \
npm start
@@ -35,12 +41,14 @@ dev-claude: build
# Example: OPENAI_API_KEY=sk-xxx make dev-model MODEL=gpt-4-turbo
dev-model: build
CLERUM_DEV_MODE=true \
+ CLERUM_ENABLE_AUTH=false \
CLERUM_MODEL_NAME=$(MODEL) \
npm start
-# Build Docker image
+# Build Docker image. The build context is the repo root (..) because the
+# Dockerfile COPYs the shared packages/ that mcp-host links via file: deps.
docker-build:
- docker build -t $(REGISTRY)/$(IMAGE_NAME):$(TAG) .
+ docker build -f Dockerfile -t $(REGISTRY)/$(IMAGE_NAME):$(TAG) ..
# Push Docker image
docker-push: docker-build
@@ -48,5 +56,5 @@ docker-push: docker-build
# Build and push multi-platform image (for M1/ARM hosts targeting amd64 clusters)
docker-push-cross:
- docker buildx build --platform linux/amd64 -t $(REGISTRY)/$(IMAGE_NAME):$(TAG) --push .
+ docker buildx build --platform linux/amd64 -t $(REGISTRY)/$(IMAGE_NAME):$(TAG) -f Dockerfile --push ..
diff --git a/mcp-host/package-lock.json b/mcp-host/package-lock.json
index d589c42bd..1928bc87d 100644
--- a/mcp-host/package-lock.json
+++ b/mcp-host/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-mcp-host",
- "version": "0.1.556",
+ "version": "0.1.557",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-mcp-host",
- "version": "0.1.556",
+ "version": "0.1.557",
"license": "SEE LICENSE IN LICENSE",
"dependencies": {
"@anthropic-ai/sdk": "^0.32.0",
diff --git a/mcp-host/package.json b/mcp-host/package.json
index 4ea1e8ea3..2e9f5111a 100644
--- a/mcp-host/package.json
+++ b/mcp-host/package.json
@@ -1,6 +1,6 @@
{
"name": "clerum-mcp-host",
- "version": "0.1.556",
+ "version": "0.1.557",
"description": "MCP Host - reads Host CRD and provides LLM access via OpenAI/Claude",
"main": "dist/main.js",
"engines": {