npm package: @rafaeelricco/mcp-server
Description: Model Context Protocol server providing AI agents with tools for project conventions, wireframe generation, full-stack app scaffolding, and deployment automation.
Author: Ambar
Latest version: 0.1.4

# Ambar MCP Server

[![NPM Package](https://img.shields.io/badge/npm-%40rafaeelricco%2Fmcp--server-red?logo=npm)](https://www.npmjs.com/package/@rafaeelricco/mcp-server)
[![NPM Version](https://img.shields.io/npm/v/%40rafaeelricco%2Fmcp-server)](https://www.npmjs.com/package/@rafaeelricco/mcp-server)
[![MIT License](https://img.shields.io/npm/l/%40rafaeelricco%2Fmcp-server)](./LICENSE)

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

<details>
<summary><b>Install in Cursor</b></summary>

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](https://docs.cursor.com/context/model-context-protocol) for more info.

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

[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=ambar-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1jcC1yZW1vdGUiLCJodHRwczovL2FtYmFyLW1jcC1zZXJ2ZXIuZmx5LmRldi9tY3AiXX0%3D)

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

</details>

<details>
<summary><b>Install in Claude Code</b></summary>

Run this command. See [Claude Code MCP docs](https://docs.anthropic.com/en/docs/claude-code/mcp) for more info.

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

</details>

<details>
<summary><b>Install in Codex</b></summary>

MCP configuration for Codex is stored within the `~/.codex/config.toml` configuration file. See [Codex MCP docs](https://codex.openai.com) for more info.

#### Using the CLI

```sh
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:

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

</details>

<details>
<summary><b>Install in VS Code</b></summary>

Add this to your VS Code MCP config file. See [VS Code MCP docs](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) for more info.

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

</details>

<details>
<summary><b>Install in Windsurf</b></summary>

Add this to your Windsurf MCP config file. See [Windsurf MCP docs](https://docs.windsurf.com/windsurf/cascade/mcp) for more info.

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

</details>

<details>
<summary><b>Install in Zed</b></summary>

Add this to your Zed `settings.json`. See [Zed Context Server docs](https://zed.dev/docs/assistant/context-servers) for more info.

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

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

</details>

## Development

```bash
# 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