Ambar MCP Server

Model Context Protocol server providing AI agents with tools for project conventions, wireframe generation, full-stack app scaffolding, and deployment automation.

Available Tools

Ambar MCP provides the following tools that LLMs can use:

• get_project_conventions: Returns project coding conventions, patterns, and style guidelines for TypeScript functional programming.
  • Input: None
  • Output: XML-formatted conventions covering:
    • Functional programming principles (monadic types, immutability, composition)
    • Type safety patterns (branded types, strict generics)
    • Naming conventions (PascalCase, camelCase, kebab-case)
    • Code patterns (imports, exports, discriminated unions, exhaustive matching)
    • React patterns (compound components, render props)

Coming Soon

• evaluate_requirements (soon) - Analyzes project requirements to identify gaps, validate constraints, and suggest improvements.

  • Input: Requirements document (text/markdown)
  • Output: Structured evaluation with recommendations

• generate_wireframe (soon) - Creates UI wireframes from natural language descriptions.

  • Input: UI description, target platform
  • Output: Wireframe specification (JSON/SVG)

• scaffold_frontend (soon) - Generates frontend app structure with AI-assisted customization.

  • Input: App type, framework preference, features
  • Output: Project scaffold with configured files

• scaffold_backend (soon) - Generates backend app structure with AI-assisted customization.

  • Input: API type, framework preference, features
  • Output: Project scaffold with configured files

Installation

Requirements

• Node.js >= v18.0.0
• Cursor, Claude Code, Codex, VS Code, Windsurf, Zed or another MCP Client

Go to: Settings -> Cursor Settings -> MCP -> Add new global MCP server

Pasting the following configuration into your Cursor ~/.cursor/mcp.json file is the recommended approach. You may also install in a specific project by creating .cursor/mcp.json in your project folder. See Cursor MCP docs for more info.

Since Cursor 1.0, you can click the install button below for instant one-click installation.

{
  "mcpServers": {
    "ambar-server": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://ambar-mcp-server.fly.dev/mcp"]
    }
  }
}

Run this command. See Claude Code MCP docs for more info.

claude mcp add --transport http ambar-server https://ambar-mcp-server.fly.dev/mcp

MCP configuration for Codex is stored within the ~/.codex/config.toml configuration file. See Codex MCP docs for more info.

Using the CLI

codex mcp add ambar-server -- npx -y mcp-remote https://ambar-mcp-server.fly.dev/mcp

Using config.toml

Add this to your ~/.codex/config.toml file:

[mcp_servers.ambar-server]
url = "https://ambar-mcp-server.fly.dev/mcp"

Add this to your VS Code MCP config file. See VS Code MCP docs for more info.

"mcp": {
  "servers": {
    "ambar-server": {
      "type": "http",
      "url": "https://ambar-mcp-server.fly.dev/mcp"
    }
  }
}

Add this to your Windsurf MCP config file. See Windsurf MCP docs for more info.

{
  "mcpServers": {
    "ambar-server": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://ambar-mcp-server.fly.dev/mcp"]
    }
  }
}

Add this to your Zed settings.json. See Zed Context Server docs for more info.

Note: Zed only supports stdio servers (local development).

{
  "context_servers": {
    "ambar-server": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "@rafaeelricco/mcp-server"]
    }
  }
}

Development

# Clone
git clone https://github.com/rafaeelricco/ambar-mcp-server.git
cd ambar-mcp-server

# Install
pnpm install

# Build
pnpm build

# Run HTTP server
pnpm start

# Run stdio server
pnpm start:stdio

Roadmap

Future tools planned:

• [x] get_project_conventions - Project coding conventions
• [ ] evaluate_requirements - Requirements analysis
• [ ] generate_wireframe - Wireframe design generation
• [ ] scaffold_frontend - Frontend app builder
• [ ] scaffold_backend - Backend app builder

License

MIT