accp

accp

Auto Create Code with Pattern files.

Define your API in .api files, then generate any language — TypeScript, Flutter, Swagger, and more — through customizable pattern files. Includes an MCP server for LLM integration.

.api / .code / .struct  →  accp --compile  →  pattern/*.js  →  Generated code

Installation

npm install accp -g

Quick Start

# 1. Create example project
accp --examples my-project

# 2. Compile
cd my-project && accp --compile

Project Structure

Folder	Extension	Description
api/	.api	API endpoint definitions
code/	.code	Error codes and translations
struct/	.struct	Data structures used in API
pattern/	.js	Code generation templates

All folders are required.

Syntax

.api — API Endpoints

.code — Error Codes

.struct — Data Structures

Compile

CLI

Command	Description
accp --compile	Compile and generate code
accp --examples <dir>	Create example project

Pattern Files

Pattern files receive OBJ (compiled data) and GEN (file writer) as arguments:

module.exports = function (OBJ, GEN) {
  const file = new GEN("output/api.ts");
  file.open();
  file.print("// generated code\n");
  file.close();
};

GEN Methods

Method	Description
new GEN(path)	Create instance (auto-creates dirs)
.open(encoding?)	Start writing (default: utf8)
.print(string)	Append content
.close()	Flush buffer to file

OBJ Structure

OBJ = {
  API: [{
    BASE: String,          // base path
    NAME: String,          // class name
    MARK: String,          // description
    FUNC: [{
      CODE: Int,           // endpoint code
      NAME: String,        // function name
      DESC: String,        // description
      (GET|PUT|POST|PATCH|DELETE): String,  // method: path
      PARAM: [String],     // path parameters
      COMP: Boolean,       // completion status
      PROC: [{ CODE, NAME }],              // related endpoints
      MARK: [{ NAME, MARK }],              // comments
      REQ: [{ NAME, MARK, CLASS, ARRAY, OPTION }],  // request fields
      RES: [{ ... }],      // response fields (same as REQ)
      OPT: { key: Boolean } // user-defined options
    }]
  }],

  CODE: [{
    NAME: String,
    MARK: String,
    CODE: [{ CODE: Int, NAME: String, MARK: { lang: String } }]
  }],

  STRUCT: [{
    NAME: String,
    MARK: String,
    DATA: [{ ... }]        // same as REQ fields
  }]
}

MCP Server

accp includes an MCP server (accp-mcp) for integration with LLM tools like Claude Code.

Setup

Add to your Claude Code settings (~/.claude/settings.json):

{
  "mcpServers": {
    "accp": {
      "command": "accp-mcp"
    }
  }
}

Available Tools

Tool	Description
accp_compile	Parse .api/.code/.struct into JSON (OBJ)
accp_generate	Compile and run pattern files to generate code
accp_validate	Check syntax without generating
accp_list_patterns	List available pattern files
accp_read_file	Read an accp source file
accp_write_file	Write an accp source file
accp_parse_string	Parse accp syntax from a string

VS Code Extension

accp language support — syntax highlighting and snippets for .api, .code, .struct files.

Snippets: API, CODE, STRUCT

Built-in Types

Int Float Double String Boolean Data

Programmatic Usage

const accp = require('accp');

The core.js module exposes the compiler for use in Node.js applications.

License

MIT