Skip to main content
Glama
przemyslawzielinski87-debug

akm-bridge

by przemyslawzielinski87-debug
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

AKM Bridge

Controlled, read-only adapter for AKM v0.8.1 in OpenCode v1.16.0.

Components

Component

Path

Purpose

Adapter library

src/adapter.ts

Core AKM binary wrapper with exit code 4 hardening

MCP server

src/mcp-server.ts

JSON-RPC over stdio — 14 AKM tools for OpenCode

HTTP API

src/http-server.ts

REST API on 127.0.0.1:4199

Types

src/types.ts

Normalized response contracts

Config

src/config.ts

Binary path, timeouts, limits

Related MCP server: data-mcp

Quick Start

cd /root/projekt/akm-bridge
bun install
bun run build
bun test
bun run start          # MCP server (stdio)
bun run start:http     # HTTP API
bun run dev:mcp        # MCP from source (tsx)

Architecture

OpenCode
├── CLI shell ──────→ akm
├── MCP ───────────→ akm-bridge ──→ akm CLI
└── AGENTS.md ─────→ supervised workflow instructions

Plugin decision: akm-opencode is intentionally not installed. The production integration is CLI + MCP bridge + AGENTS.md. See docs/AKM-OPENCODE-INTEGRATION.md for full rationale.

Exit Code 4 Note

akm health exits with code 4 (warn status). The adapter accepts this only when stdout is valid JSON containing a health/warn response. All other non-zero exit codes are rejected. See docs/AKM-OPENCODE-INTEGRATION.md.

Documentation

File

Content

docs/AKM-OPENCODE-INTEGRATION.md

Full architecture, exit code 4 handling, test commands

docs/DEPLOYMENT.md

Deployment steps and prerequisites

docs/RECOVERY.md

Recovery procedures

docs/examples/opencode-akm-mcp.example.json

MCP config template

scripts/deploy-akm-bridge.sh

Automated deployment script

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers

  • data-mcp

    Tattzy25
    A
    license
    Not graded
    quality
    B
    maintenance
    MCP server generated from an OpenAPI Specification, exposing tools via HTTP. It allows clients to invoke API operations using JSON-RPC 2.0 requests.
    4 npm
    Artistic 2.0

  • mcp-tool-framework

    tanghui2
    A
    license
    Not graded
    quality
    C
    maintenance
    An MCP server framework enabling standardized tool registration, discovery, and invocation over JSON-RPC 2.0, with support for InProcess, SSE, and WebSocket transports, plus built-in tools such as calculator, text processor, and JSON formatter.
    MIT