feat(opencode): add opencode MCP server (#4)

Signed-off-by: Ettore Di Giacinto <mudler@localai.io>

Author: mudler

.github/workflows/image.yml

@@ -17,7 +17,40 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        mcp: [duckduckgo, weather, wait, memory, homeassistant, scripts, localrecall, twitter, todo, mailbox]
+        include:
+          - mcp: duckduckgo
+            dockerfile: ./Dockerfile
+            context: ./
+          - mcp: weather
+            dockerfile: ./Dockerfile
+            context: ./
+          - mcp: wait
+            dockerfile: ./Dockerfile
+            context: ./
+          - mcp: memory
+            dockerfile: ./Dockerfile
+            context: ./
+          - mcp: homeassistant
+            dockerfile: ./Dockerfile
+            context: ./
+          - mcp: scripts
+            dockerfile: ./Dockerfile
+            context: ./
+          - mcp: localrecall
+            dockerfile: ./Dockerfile
+            context: ./
+          - mcp: twitter
+            dockerfile: ./Dockerfile
+            context: ./
+          - mcp: todo
+            dockerfile: ./Dockerfile
+            context: ./
+          - mcp: mailbox
+            dockerfile: ./Dockerfile
+            context: ./
+          - mcp: opencode
+            dockerfile: ./opencode/Dockerfile
+            context: ./
     permissions:
       packages: write
       contents: read
@@ -57,8 +90,8 @@ jobs:
         uses: docker/build-push-action@v6
         with:
           builder: ${{ steps.buildx.outputs.name }}
-          context: ./
-          file: ./Dockerfile
+          context: ${{ matrix.context }}
+          file: ${{ matrix.dockerfile }}
           platforms: linux/amd64,linux/arm64
           push: true
           tags: ${{ steps.meta.outputs.tags }}
@@ -72,8 +105,8 @@ jobs:
         uses: docker/build-push-action@v6
         with:
           builder: ${{ steps.buildx.outputs.name }}
-          context: ./
-          file: ./Dockerfile
+          context: ${{ matrix.context }}
+          file: ${{ matrix.dockerfile }}
           platforms: linux/amd64,linux/arm64
           tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}

Makefile

@@ -11,6 +11,15 @@ GO_VERSION ?= 1.25.1
 # Docker image name
 IMAGE_NAME = $(DOCKER_REGISTRY)/$(DOCKER_REPOSITORY)/$(MCP_SERVER)
 
+# Docker build configuration - can be overridden per server
+DOCKER_CONTEXT ?= ./
+DOCKER_FILE ?= ./Dockerfile
+
+# Override for opencode (custom Dockerfile)
+ifeq ($(MCP_SERVER),opencode)
+DOCKER_FILE = ./opencode/Dockerfile
+endif
+
 # Default target
 .PHONY: help
 help: ## Show this help message
@@ -20,23 +29,27 @@ help: ## Show this help message
 .PHONY: build
 build: ## Build the Docker image locally
 	@echo "Building Docker image: $(IMAGE_NAME):$(DOCKER_TAG)"
+	@echo "Using Dockerfile: $(DOCKER_FILE)"
+	@echo "Build context: $(DOCKER_CONTEXT)"
 	docker build \
 		--build-arg MCP_SERVER=$(MCP_SERVER) \
 		--build-arg GO_VERSION=$(GO_VERSION) \
 		-t $(IMAGE_NAME):$(DOCKER_TAG) \
-		-f Dockerfile \
-		.
+		-f $(DOCKER_FILE) \
+		$(DOCKER_CONTEXT)
 
 .PHONY: build-multiarch
 build-multiarch: ## Build multi-architecture Docker image (requires buildx)
 	@echo "Building multi-architecture Docker image: $(IMAGE_NAME):$(DOCKER_TAG)"
+	@echo "Using Dockerfile: $(DOCKER_FILE)"
+	@echo "Build context: $(DOCKER_CONTEXT)"
 	docker buildx build \
 		--platform linux/amd64,linux/arm64 \
 		--build-arg MCP_SERVER=$(MCP_SERVER) \
 		--build-arg GO_VERSION=$(GO_VERSION) \
 		-t $(IMAGE_NAME):$(DOCKER_TAG) \
-		-f Dockerfile \
-		.
+		-f $(DOCKER_FILE) \
+		$(DOCKER_CONTEXT)
 
 .PHONY: run
 run: build ## Build and run the container locally
@@ -46,12 +59,14 @@ run: build ## Build and run the container locally
 .PHONY: test-build
 test-build: ## Test build without pushing (similar to PR build in CI)
 	@echo "Testing build (PR mode): $(IMAGE_NAME):$(DOCKER_TAG)"
+	@echo "Using Dockerfile: $(DOCKER_FILE)"
+	@echo "Build context: $(DOCKER_CONTEXT)"
 	docker build \
 		--build-arg MCP_SERVER=$(MCP_SERVER) \
 		--build-arg GO_VERSION=$(GO_VERSION) \
 		-t $(IMAGE_NAME):$(DOCKER_TAG) \
-		-f Dockerfile \
-		.
+		-f $(DOCKER_FILE) \
+		$(DOCKER_CONTEXT)
 
 .PHONY: push
 push: build ## Build and push to registry (requires authentication)
@@ -150,3 +165,5 @@ info: ## Show build information
 	@echo "Go Version: $(GO_VERSION)"
 	@echo "Docker Registry: $(DOCKER_REGISTRY)"
 	@echo "Repository: $(DOCKER_REPOSITORY)"
+	@echo "Dockerfile: $(DOCKER_FILE)"
+	@echo "Context: $(DOCKER_CONTEXT)"

README.md

@@ -1146,6 +1146,128 @@ mcp:
 
 **Note:** Each agent instance must have a unique `MAILBOX_AGENT_NAME` to properly filter and manage its own messages. The mailbox file is shared across all agents, but each agent only sees messages where it is the recipient.
 
+### 🚀 Opencode Server
+
+An MCP server for controlling opencode AI sessions asynchronously. Start sessions, monitor progress, retrieve logs, and manage multiple concurrent opencode processes.
+
+**Features:**
+- Async session management with unique session IDs
+- Start opencode sessions with full command-line option support
+- Monitor session status (running, completed, failed, stopped)
+- Retrieve stdout/stderr logs from sessions
+- Stop running sessions gracefully
+- List all sessions with filtering by status
+- Configurable concurrent session limits
+- Automatic log cleanup based on retention policy
+- Ephemeral sessions (do not survive server restarts)
+
+**Tools:**
+- `start_session` - Start a new opencode session with a message and options
+- `get_session_status` - Get the current status of a session by ID
+- `get_session_logs` - Retrieve stdout and stderr logs from a session
+- `stop_session` - Stop a running session
+- `list_sessions` - List all sessions with optional status filtering
+
+**Configuration:**
+- `OPENCODE_SESSION_DIR` - Directory for session state and logs (default: `/tmp/opencode-sessions`)
+- `OPENCODE_BINARY` - Path to opencode binary (default: `/usr/local/bin/opencode`)
+- `OPENCODE_MAX_SESSIONS` - Maximum number of concurrent sessions (default: `10`)
+- `OPENCODE_LOG_RETENTION_HOURS` - Hours to retain session logs before cleanup (default: `24`)
+- `OPENCODE_CONFIG` - Path to opencode config file
+- `OPENCODE_CONFIG_CONTENT` - Inline config as JSON string
+- `OPENCODE_MODEL` - Model to use in provider/model format (e.g., `openai/gpt-4`)
+- `OPENCODE_FORMAT` - Output format: `default` (formatted) or `json` (raw JSON events) (default: `json`)
+- `OPENCODE_AGENT` - Agent to use for sessions
+- `OPENCODE_SHARE` - Share sessions: `true` or `false` (default: `false`)
+- `OPENCODE_VARIANT` - Model variant for provider-specific reasoning effort
+
+**Start Session Example:**
+```json
+{
+  "message": "Explain quantum computing",
+  "title": "Quantum Computing Explanation"
+}
+```
+
+**Start Session Output:**
+```json
+{
+  "session_id": "550e8400-e29b-41d4-a716-446655440000",
+  "status": "starting",
+  "message": "Session started successfully"
+}
+```
+
+**Get Session Status Example:**
+```json
+{
+  "session_id": "550e8400-e29b-41d4-a716-446655440000"
+}
+```
+
+**Get Session Status Output:**
+```json
+{
+  "session_id": "550e8400-e29b-41d4-a716-446655440000",
+  "status": "completed",
+  "pid": "12345",
+  "exit_code": "0",
+  "created_at": "2025-01-15T10:30:00Z",
+  "started_at": "2025-01-15T10:30:01Z",
+  "stopped_at": "2025-01-15T10:30:15Z",
+  "duration": "14s"
+}
+```
+
+**Get Session Logs Example:**
+```json
+{
+  "session_id": "550e8400-e29b-41d4-a716-446655440000",
+  "lines": 50
+}
+```
+
+**Get Session Logs Output:**
+```json
+{
+  "session_id": "550e8400-e29b-41d4-a716-446655440000",
+  "stdout": "Quantum computing is a form of computing that takes advantage...",
+  "stderr": "",
+  "line_count": 50
+}
+```
+
+**Docker Image:**
+```bash
+docker run -e OPENCODE_MAX_SESSIONS=5 -e OPENCODE_LOG_RETENTION_HOURS=48 ghcr.io/mudler/mcps/opencode:latest
+```
+
+**With model configuration:**
+```bash
+docker run -e OPENCODE_MODEL=openai/gpt-4 -e OPENCODE_FORMAT=json ghcr.io/mudler/mcps/opencode:latest
+```
+
+**LocalAI configuration (to add to the model config):**
+```yaml
+mcp:
+  stdio: |
+    {
+      "mcpServers": {
+        "opencode": {
+          "command": "docker",
+          "env": {
+            "OPENCODE_MAX_SESSIONS": "5",
+            "OPENCODE_LOG_RETENTION_HOURS": "48"
+          },
+          "args": [
+            "run", "-i", "--rm",
+            "ghcr.io/mudler/mcps/opencode:master"
+          ]
+        }
+      }
+    }
+```
+
 ## Development
 
 ### Prerequisites
@@ -1258,6 +1380,9 @@ Docker images are automatically built and pushed to GitHub Container Registry:
 - `ghcr.io/mudler/mcps/mailbox:latest` - Latest Mailbox server
 - `ghcr.io/mudler/mcps/mailbox:v1.0.0` - Tagged versions
 - `ghcr.io/mudler/mcps/mailbox:master` - Development versions
+- `ghcr.io/mudler/mcps/opencode:latest` - Latest Opencode server
+- `ghcr.io/mudler/mcps/opencode:v1.0.0` - Tagged versions
+- `ghcr.io/mudler/mcps/opencode:master` - Development versions
 
 ## Contributing
 

go.mod

@@ -50,6 +50,7 @@ require (
 	github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
 	github.com/modern-go/reflect2 v1.0.2 // indirect
 	github.com/mschoch/smat v0.2.0 // indirect
+	github.com/mudler/go-processmanager v0.1.0 // indirect
 	github.com/pkoukk/tiktoken-go v0.1.6 // indirect
 	github.com/yosida95/uritemplate/v3 v3.0.2 // indirect
 	go.etcd.io/bbolt v1.4.0 // indirect

go.sum

@@ -128,6 +128,8 @@ github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9G
 github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk=
 github.com/mschoch/smat v0.2.0 h1:8imxQsjDm8yFEAVBe7azKmKSgzSkZXDuKkSq9374khM=
 github.com/mschoch/smat v0.2.0/go.mod h1:kc9mz7DoBKqDyiRL7VZN8KvXQMWeTaVnttLRXOlotKw=
+github.com/mudler/go-processmanager v0.1.0 h1:fcSKgF9U/a1Z7KofAFeZnke5YseadCI5GqL9oT0LS3E=
+github.com/mudler/go-processmanager v0.1.0/go.mod h1:h6kmHUZeafr+k5hRYpGLMzJFH4hItHffgpRo2QIkP+o=
 github.com/onsi/ginkgo/v2 v2.28.1 h1:S4hj+HbZp40fNKuLUQOYLDgZLwNUVn19N3Atb98NCyI=
 github.com/onsi/ginkgo/v2 v2.28.1/go.mod h1:CLtbVInNckU3/+gC8LzkGUb9oF+e8W8TdUsxPwvdOgE=
 github.com/onsi/gomega v1.39.1 h1:1IJLAad4zjPn2PsnhH70V4DKRFlrCzGBNrNaru+Vf28=

opencode/Dockerfile

@@ -0,0 +1,60 @@
+# Build stage
+FROM golang:1.24-alpine AS builder
+
+WORKDIR /app
+
+# Copy go mod files
+COPY go.mod go.sum ./
+RUN go mod download
+
+# Copy source code
+COPY opencode/ ./opencode/
+
+# Build the binary
+RUN CGO_ENABLED=0 GOOS=linux go build -o opencode-mcp-server ./opencode/
+
+# Final stage - use Debian instead of Alpine for glibc compatibility
+FROM debian:bookworm-slim
+
+# Install required runtime dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    ca-certificates \
+    curl \
+    bash \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install opencode and capture the installation location
+RUN curl -fsSL https://opencode.ai/install | bash && \
+    # Find where opencode was installed and link it to /usr/local/bin
+    if [ -f /root/.local/bin/opencode ]; then \
+        ln -s /root/.local/bin/opencode /usr/local/bin/opencode; \
+    elif [ -f /root/.opencode/bin/opencode ]; then \
+        ln -s /root/.opencode/bin/opencode /usr/local/bin/opencode; \
+    fi
+
+# Copy the MCP server binary
+COPY --from=builder /app/opencode-mcp-server /usr/local/bin/opencode-mcp-server
+
+# Verify opencode works in final container
+RUN which opencode && opencode --version || echo "Warning: opencode may not be properly installed"
+
+# Create session directory
+RUN mkdir -p /tmp/opencode-sessions
+
+# Set environment variables
+ENV OPENCODE_SESSION_DIR=/tmp/opencode-sessions
+ENV OPENCODE_BINARY=/usr/local/bin/opencode
+ENV OPENCODE_MAX_SESSIONS=10
+ENV OPENCODE_LOG_RETENTION_HOURS=24
+ENV OPENCODE_FORMAT=json
+ENV OPENCODE_SHARE=false
+
+# Optional environment variables (uncomment to use):
+# ENV OPENCODE_MODEL=openai/gpt-4
+# ENV OPENCODE_AGENT=
+# ENV OPENCODE_VARIANT=
+# ENV OPENCODE_ATTACH=
+# ENV OPENCODE_PORT=0
+
+# Run the MCP server
+ENTRYPOINT ["opencode-mcp-server"]