POEM Server

MCP server for POEM (Pseudo-code Oriented Executable Markup).

Write specs once, get code in any language.

Tools

Tool	What it does
poem_read	Parse a .poem file into structured elements
poem_validate	Check syntax and naming conventions
poem_translate	Prepare a spec for translation to any language

Install

Clone and build:

git clone https://github.com/openpoem/poem-mcp.git
cd poem-mcp
npm install && npm run build

Configure

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "poem": {
      "command": "node",
      "args": ["/path/to/poem-mcp/dist/mcp.js"]
    }
  }
}

Usage

Read a POEM

"Read this poem file and explain what it does"

The poem_read tool parses .poem files into structured elements (constants, structs, functions, enums, etc).

Validate a POEM

"Validate this poem spec"

Checks for syntax errors, naming convention compliance, and structural completeness.

Translate a POEM

"Translate this poem to Python"

The tool parses and validates the spec, then provides a structured translation brief with language-specific type mappings. The LLM then generates idiomatic code.

Supported targets: Python, TypeScript, Go, Rust, Java, Swift, Kotlin, SQL, and any other language.

Example

// pricing.poem
const TAX_RATE = 0.21;

struct Product {
  name: string;
  price: float;
}

fn total(p: Product, qty: int) -> float {
  return p.price * qty * (1 + TAX_RATE);
}

Ask: "Translate to Go" and get:

const TAX_RATE = 0.21

type Product struct {
    Name  string
    Price float64
}

func Total(p Product, qty int64) float64 {
    return p.Price * float64(qty) * (1 + TAX_RATE)
}

Origin

Built by OpenPoem

License

MIT