@leg3ndy/mcpb

MCP bundle manifest validation and configuration helpers for Otto plugins.

This package is intentionally small. It provides the runtime contract Otto Code needs to load .mcpb and .dxt bundles:

• manifest validation
• user configuration option types
• MCP server config generation from bundle manifests
• ${user_config.KEY}, ${__dirname}, and system directory substitution

Installation

npm install @leg3ndy/mcpb

Validate a Manifest

import { McpbManifestSchema } from '@leg3ndy/mcpb'

const result = McpbManifestSchema.safeParse(manifestJson)

if (!result.success) {
  console.error(result.error.flatten())
}

Generate MCP Config

import { getMcpConfigForManifest } from '@leg3ndy/mcpb'

const config = await getMcpConfigForManifest({
  manifest,
  extensionPath: '/path/to/extracted/bundle',
  systemDirs: {
    HOME: process.env.HOME ?? '',
  },
  userConfig: {
    API_KEY: 'secret',
  },
  pathSeparator: '/',
})

console.log(config)

Supported Server Forms

The first release supports:

• direct server.command / server.args stdio configs
• direct server.url remote configs for http, sse, and ws
• server.mcp_config object passthrough
• node, python, and binary server entry points

License

UNLICENSED. Copyright LEG3NDY.