itxaiohanglover/mcp-codestyle-server/codestyle

Codestyle

Code template management: CLI tools for search/get/upload + AI-guided generation.

Decision Tree

User request
    │
    ├─ "search" / "检索" ──→ Search Workflow (CLI, local+remote)
    │
    ├─ "get" / "获取" ──→ Get Workflow (CLI, local+remote)
    │
    ├─ "generate" / "生成" ──→ Generate Workflow (AI dialog, then upload)
    │
    └─ "upload" / "上传" ──→ Upload Workflow (CLI, remote)

Commands

Quick Start

Windows

"<SKILL_DIR>\scripts\codestyle.bat" search "keyword"
"<SKILL_DIR>\scripts\codestyle.bat" get "template-path"
"<SKILL_DIR>\scripts\codestyle.bat" upload --path ./my-template

Linux/macOS

bash <SKILL_DIR>/scripts/codestyle search "keyword"
bash <SKILL_DIR>/scripts/codestyle get "template-path"
bash <SKILL_DIR>/scripts/codestyle upload --path ./my-template

Generate (AI Dialog)

User: 把这段代码做成模板：[代码]
AI: [多轮对话引导生成模板]
AI: [调用 upload 存储]

Workflows

See references/ for detailed workflow instructions:

• [Search Workflow](references/search-workflow.md) - Find templates (local+remote)
• [Get Workflow](references/get-workflow.md) - Retrieve template content by full path
• [Generate Workflow](references/generate-workflow.md) - AI-guided template creation
• [Upload Workflow](references/upload-workflow.md) - Submit templates (remote)

Generate Workflow Overview

Generate workflow is pure AI dialog, no script calls until final upload.

Process: 识别输入 → 预处理 → 分析结构 → 选择模板 → AI生成 → 去重检测 → 用户确认 → 调用upload

First-Time Use

Automatic initialization on first command:

1. Detect no .initialized marker
2. Download JAR file (if needed)
3. Clone template repository
4. Create .initialized marker
5. Execute original command

Configuration

See references/config.md for configuration options.

Template Format

Directory Structure

Standard template structure with meta.json in version directory:

<artifactId>/
└── <version>/
    ├── meta.json          # Template metadata (required)
    ├── README.md          # Documentation (optional)
    └── <subdirectories>   # Template files (.ftl)

Example:

CRUD/
└── 1.0.0/
    ├── meta.json
    ├── README.md
    ├── backend/
    │   ├── sql/Menu.ftl
    │   └── src/main/java/...
    └── frontend/
        └── src/...

See references/template-format.md for complete format specification.

See references/template-syntax.md for template syntax.

Requirements

• JDK 17+
• Git 2.0+ (for first-time setup and repo cloning)
• Internet connection (for remote API calls)