onelinemcp 0.1.0

Compile a tools.txt spec into MCP tool definitions

Singleline is a compiler that takes a text file and spits out an MCP server. Write your tools as one-liners, get a working Python or TypeScript server on the other end.

No boilerplate. No wrappers. Just name:command and go.

Features

• Declarative tool definitions: name:command pairs
• Parameters extracted automatically from {placeholders}
• Generates Python (FastMCP) or TypeScript (@modelcontextprotocol/sdk)
• Inline or standalone descriptions via the #! prefix

Installation

Python 3.x and jinja2:

pip install jinja2

Usage

1. Write a tools.txt

#! List files in a directory
ls:ls -la {path}

#! Check system uptime
uptime:uptime

#! Run a custom bash command
bash: /usr/bin/env bash -c "{command}"

2. Compile

Python:

python singleline.py --mcp tools.txt --lang python > tools.py

TypeScript:

python singleline.py --mcp tools.txt --lang typescript > tools.ts

Command Line Arguments

Argument	Short	Required	Description
--mcp		Yes	Path to the spec file
--lang		Yes	python or typescript
--output	-o	No	Output file (defaults to stdout)

Spec Format

• Tool: name:command
• Parameters: {like_this} in the command string becomes a tool input
• Descriptions:
  • Inline: name:command #! Description here
  • Standalone: #! Description here on the line before the tool
• Comments: Lines starting with # (but not #!) are ignored

Generated Code Requirements

Python: mcp (FastMCP)

TypeScript: @modelcontextprotocol/sdk, Node.js with child_process and util