FrameLayoutKit MCP Server
Provides AI-powered assistance for iOS developers using the FrameLayoutKit framework, including code generation for various layout types, Auto Layout conversion, code validation, and migration guidance for UIKit projects.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@FrameLayoutKit MCP Server convert this Auto Layout stack view to FrameLayoutKit syntax"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
FrameLayoutKit MCP Server
A Model Context Protocol (MCP) server for FrameLayoutKit, providing AI-powered assistance for iOS developers using the FrameLayoutKit framework. This server helps generate Swift UIKit code using FrameLayoutKit's intuitive syntax, convert existing Auto Layout code, validate layouts, and provide migration guidance.
Features
🚀 Code Generation
Generate FrameLayoutKit code for all layout types:
FrameLayout - Single view container with padding and alignment
VStackLayout/HStackLayout - Vertical/horizontal stacks
ZStackLayout - Overlapping views
DoubleFrameLayout - Two-view layouts with distribution control
GridFrameLayout - Multi-row/column grid layouts
ScrollStackView - Scrollable stacks
FlowFrameLayout - Wrapping flow layouts
🔄 Auto Layout Conversion
Convert existing UIKit Auto Layout code to FrameLayoutKit:
NSLayoutConstraint conversion
UIStackView migration
Layout anchor transformation
Preserves code structure and comments
✅ Code Validation
Validate FrameLayoutKit code for:
Syntax correctness
Semantic validity
Best practices
Performance optimization suggestions
📋 Migration Assistance
Generate comprehensive migration guides:
Project-wide analysis
File-by-file recommendations
Effort estimation
Step-by-step migration strategy
Related MCP server: MCP Xcode
Installation
# Clone the repository
git clone https://github.com/kennic/framelayoutkit-mcp.git
cd framelayoutkit-mcp
# Install dependencies
npm install
# Start the server
npm startConfiguration
For Claude Desktop
Add to your Claude configuration file:
{
"mcpServers": {
"framelayoutkit": {
"command": "node",
"args": ["/path/to/framelayoutkit-mcp/src/index.js"],
"env": {}
}
}
}For VS Code with Continue
Add to your Continue configuration:
{
"models": [{
"title": "Claude with FrameLayoutKit",
"provider": "anthropic",
"model": "claude-3-sonnet",
"mcpServers": [{
"name": "framelayoutkit",
"command": "node",
"args": ["./framelayoutkit-mcp/src/index.js"]
}]
}]
}Usage Examples
Generate a VStackLayout
// Request
{
"tool": "generate-framelayout",
"arguments": {
"layoutType": "VStackLayout",
"views": [
{
"name": "titleLabel",
"type": "UILabel",
"text": "Welcome"
},
{
"name": "button",
"type": "UIButton",
"text": "Get Started"
}
],
"configuration": {
"spacing": 20,
"padding": 16,
"distribution": "center"
}
}
}Generated Swift code:
// Add views to stack
let titleLabel = {
let label = UILabel()
label.text = "Welcome"
return label
}()
let button = {
let button = UIButton(type: .system)
button.setTitle("Get Started", for: .normal)
return button
}()
let stackLayout = VStackLayout()
stackLayout.spacing(20).distribution(.center).padding(16)
stackLayout + titleLabel
stackLayout + buttonConvert Auto Layout to FrameLayoutKit
// Request
{
"tool": "convert-autolayout",
"arguments": {
"swiftCode": "/* Your existing Auto Layout code */",
"options": {
"migrationStrategy": "conservative",
"useOperatorSyntax": true
}
}
}Validate FrameLayoutKit Code
// Request
{
"tool": "validate-framelayout",
"arguments": {
"swiftCode": "/* Your FrameLayoutKit code */",
"checkLevel": "full"
}
}FrameLayoutKit Syntax Verification
The MCP server correctly implements FrameLayoutKit's syntax patterns:
✅ Operator Usage
+operator for adding views to layouts<+and+>operators for DoubleFrameLayoutChainable method syntax
✅ Layout Properties
Correct alignment enums (
.top,.center,.bottom,.fill,.fit)Distribution options per layout type
Proper padding/spacing application
✅ View Wrapping
All views automatically wrapped in FrameLayout instances
Individual item configuration support
Correct frame calculation delegation
✅ Layout Hierarchies
Proper nesting of layout types
Correct parent-child relationships
Internal stack management for Grid and Flow layouts
Architecture
The server is built with:
Node.js with ES modules
@modelcontextprotocol/sdk for MCP implementation
Zod for schema validation
Modular class structure for each tool
Key Components
FrameLayoutGenerator - Generates FrameLayoutKit code
AutoLayoutConverter - Converts Auto Layout to FrameLayoutKit
FrameLayoutValidator - Validates syntax and semantics
MigrationAnalyzer - Analyzes projects for migration
Contributing
Contributions are welcome! Please ensure:
Code follows FrameLayoutKit's official syntax
All generated code is valid Swift
Tests cover new functionality
Documentation is updated
License
MIT License - see LICENSE file for details
Support
For issues and questions:
GitHub Issues: framelayoutkit-mcp/issues
FrameLayoutKit Documentation: FrameLayoutKit Docs
Acknowledgments
FrameLayoutKit by Nam Kennic
Anthropic's Model Context Protocol
The iOS development community
Available Tools
5 toolsconvert-autolayoutB
Convert Auto Layout code to FrameLayoutKit syntax
Inputs: swiftCode (required), options.
generate-framelayoutC
Generate FrameLayoutKit code for iOS layouts
Inputs: layoutType (required), views (required), configuration.
generate-migration-guideC
Generate a migration guide for converting projects to FrameLayoutKit
Inputs: projectPath, swiftFiles, outputFormat.
generate-viewcontrollerC
Generate complete view controller with FrameLayoutKit layouts
Inputs: layoutStructure (required), className.
validate-framelayoutB
Validate FrameLayoutKit code for syntax and semantic correctness
Inputs: swiftCode (required), checkLevel.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a distinct purpose: conversion, generation, migration guide, view controller generation, and validation. No overlap in functionality.
All tool names follow a consistent verb_noun pattern in snake_case, e.g., convert-autolayout, generate-framelayout.
5 tools is well-scoped for a focused framework assistance server, covering key developer tasks without excess.
The tool set covers the main workflows: converting existing code, generating new layouts, validating, creating view controllers, and providing migration guides. No obvious gaps.
Related MCP Connectors
Ship a new iOS app from chat. AI runs App Store Connect, builds, release, and submission through Ap…
Apple developer docs and WWDC transcripts with RAG retrieval and Jev relevance ranking.
Flutter in-app bug tracking, visual pin annotations, and device logs directly into your AI IDE.
Cloud iPhones and Macs with Xcode for AI agents: build, run and test iOS apps, use the screen.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides programmatic access to Xcode functionality, enabling AI assistants to create, build, test, and manage iOS/macOS projects directly.335MIT
- AlicenseBqualityDmaintenanceEnables AI assistants to build, test, run, and manage Apple platform projects (iOS, macOS, tvOS, watchOS, visionOS) directly through Xcode. Provides comprehensive control over Xcode projects, Swift packages, simulators, and development workflows without leaving your editor.57 npm2MIT
- AlicenseNot gradedqualityDmaintenanceEnables comprehensive control of iOS simulators and real devices through AI assistants, supporting app management, UI automation, screenshots, media operations, and location simulation for iOS development and testing workflows.8MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to diagnose and fix iOS app issues that cause App Store rejections, such as missing privacy manifests, permission strings, and test credentials, before submission.167 npm2MIT