@alcyone-labs/arg-parser-mcp

MCP (Model Context Protocol) plugin for @alcyone-labs/arg-parser.

Installation

npm install @alcyone-labs/arg-parser @alcyone-labs/arg-parser-mcp

Quick Start

import { ArgParser } from "@alcyone-labs/arg-parser";
import { mcpPlugin } from "@alcyone-labs/arg-parser-mcp";

const parser = new ArgParser({
  appName: "my-cli",
  handler: async (ctx) => ({ result: "success" }),
}).use(
  mcpPlugin({
    serverInfo: {
      name: "my-mcp-server",
      version: "1.0.0",
      description: "My MCP server",
    },
  }),
);

await parser.parse();

Features

• Expose CLI tools as MCP tools
• Support for stdio, SSE, and streamable HTTP transports
• Automatic tool schema generation from flags
• Resource and prompt management
• Lifecycle event handling

API

mcpPlugin(options)

Creates an MCP plugin instance.

Options

• serverInfo (required): Server metadata
  • name: Server name
  • version: Server version
  • description: Server description
• defaultTransports: Array of transport configurations
• toolOptions: Tool generation options
• log: Logger configuration
• lifecycle: Lifecycle event handlers
• dxt: DXT package configuration

Methods Added to ArgParser

After installing the plugin, your ArgParser instance will have these additional methods:

• addTool(config): Add a unified CLI/MCP tool
• createMcpServer(): Create an MCP server instance
• toMcpTools(): Generate MCP tools from parser structure

License

MIT