chaitin/OctoBus

View on GitHub ↗

A secure local gateway for AI agents to reliably call approved enterprise APIs, tools, and services.

190 ★89 forksJavaScriptUpdated 18d ago

What you need to know

Locally running single-binary gateway that manages pluggable Node.js service packages and exposes their gRPC capabilities to clients or agents via capsets

Install

npm install -g @chaitin-ai/octobus
octobus serve
docker run --rm -p 9000:9000 -v octobus-data:/var/lib/octobus ghcr.io/chaitin/octobus:latest

Usage

  • octobus service import calculator ./examples/calculator-js to import a service package
  • Create instances and capsets, then call exposed methods via gRPC, Connect RPC, or MCP streamable HTTP

Key features

  • Capset model composing capset -> service -> instance -> method bindings
  • Exposes methods as gRPC, Connect RPC, MCP streamable HTTP, and OpenAPI
  • Long-running and on-demand Node.js runtime modes
  • SQLite-backed storage of services, instances, capsets and runtime state
  • gRPC reflection provided from archived descriptors
  • Access tokens per capset and NDJSON access logs

Best for

Packaging and serving Node.js gRPC services to AI agents through standardized protocols

Caveats

  • Requires node, npm, protoc and git on PATH for service import and runtime flows
  • Streaming methods only available via gRPC, not Connect RPC or MCP
  • When exposing remotely, you are responsible for network access control
Platforms: Self-hosted (127.0.0.1:9000) · DockerClients: Any MCP client

Reviewed 2026-08-11

Topics

access-controlagent-toolsai-agentsapi-gatewayauthorizationconnect-rpcdeveloper-toolsenterprise-integrationenterprise-integrationsgrpcinternal-toolsmcpmodel-context-protocolsecuritytool-callingworkflow-automation
Stars
190★
Forks
89
Language
JavaScript
License
GPL-3.0
Created
2025-12-12
Last push
2026-08-17