ebade MCP Server 🐣

Model Context Protocol (MCP) server for the ebade Agent-First Framework.

Installation

npx -y ebade-mcp-server

Or locally:

npm install ebade-mcp-server

Configuration

Add to your MCP client configuration:

For Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ebade": {
      "command": "node",
      "args": ["/path/to/ebade/packages/mcp-server/dist/index.js"]
    }
  }
}

For Cursor

Add to your Cursor MCP settings:

{
  "ebade": {
    "command": "ebade-mcp"
  }
}

Available Tools

ebade_scaffold

Create a complete project from an ebade definition.

// Example usage by an AI agent:
ebade_scaffold({
  projectName: "my-app",
  projectType: "SaaS Dashboard", // "E-commerce" or "Landing Page"
  primaryColor: "#4f46e5",
  outputDir: "/path/to/projects"
})

Output: Full Next.js project with pages, components, and styles.

ebade_validate

Validate an ebade file before scaffolding.

ebade_validate({
  intentContent: `
    name: my-app
    type: saas-dashboard
    features:
      - user-auth
      - analytics
  `
})

Output: Validation results with errors and warnings.

ebade_compile

Compile a single ebade to code.

ebade_compile({
  intent: {
    type: "page",
    name: "checkout",
    path: "/checkout",
    components: ["cart-summary", "payment-form"],
    auth: "required"
  },
  target: "nextjs"
})

Output: Generated TypeScript/React code.

ebade_generate

Generate a component from natural language.

ebade_generate({
  description: "a product card with image, title, price, and add to cart button",
  style: "minimal-modern"
})

Output: Inferred intent + generated component code.

Resources

The server also provides resources:

• ebade://syntax - Complete syntax reference
• ebade://examples/ecommerce - E-commerce example
• ebade://examples/saas - SaaS dashboard example

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

# Run
npm start

License

MIT