BardAI

What it does

BardAI is a full-stack MCP application scaffold that pairs an Express-based MCP HTTP server with a Vite + React web interface. It provides a working template for building interactive MCP apps that expose tool endpoints to AI clients over HTTP, with built-in ngrok tunnelling so ChatGPT (and other cloud-hosted clients) can reach your local server instantly. The web UI lets you observe and manage the app's state while the AI drives actions through MCP tools.

Key features

• HTTP MCP server — Express + MCP SDK serving tool endpoints at localhost:3000, ready for both local and tunnelled connections
• Vite + React web interface — Companion UI for visualising items, widgets, and server state in real time
• ngrok integration — One command to expose the local server publicly; purpose-built for ChatGPT Connectors dev workflow
• MCP Inspector support — Built-in npm run inspect script for interactive tool testing and debugging
• Monorepo structure — Clean separation of server and web concerns with shared root config

Installation

git clone https://github.com/kylecombs/BardAI
cd BardAI
npm install && cd server && npm install && cd ../web && npm install

Start the server:

cd server && npm run dev

Expose via ngrok for ChatGPT:

cd server && npm run ngrok

For Claude.ai or other HTTP-capable clients, add the ngrok (or local) URL in Settings → Integrations.

Supported hosts

ChatGPT (via ngrok HTTP endpoint), Claude (HTTP transport)