About Person App

A modern, production-ready contact management system built with cutting-edge web technologies

Application Overview

Person App is a full-stack web application demonstrating professional CRUD operations with a production-grade serverless database. Build, test, and manage person records with a beautiful, modern interface that's optimized for both desktop and mobile devices.

Modern Frontend

Next.js 16, React 19, TypeScript, Tailwind CSS

Server Actions

No REST API needed, direct database mutations

Neon PostgreSQL

Serverless, auto-scaling, connection pooling

Vercel Deployment

Edge functions, auto-scaling, CI/CD

Key Features

Create

Add new contacts with all details

👁️

Read

View records with timestamps

✏️

Update

Edit contact information

🗑️

Delete

Remove records safely

🔍

Search

Filter by multiple fields

📱

Responsive

Mobile-optimized UI

Architecture & Tech Stack

1Frontend Layer

  • Next.js 16 with Turbopack
  • React 19.2 with latest features
  • TypeScript for type safety
  • Tailwind CSS + Shadcn UI

2Backend Layer

  • Next.js Server Actions
  • Prisma ORM v7 (type-safe)
  • PG Adapter for pooling
  • Zod schema validation

3Database & Deployment

  • Neon PostgreSQL (Serverless)
  • Connection Pooling for Vercel
  • Automatic daily backups
  • Auto-scaling with traffic
User Interface (React)
Server Actions (TypeScript)
Prisma ORM (Type-safe)
PG Adapter (Connection Pool)
Neon PostgreSQL (Serverless)

AI Agent Integration with MCP

This app includes a separate Person MCP Server that enables AI agents (like Claude Desktop) to perform CRUD operations directly through the Model Context Protocol.

MCP Capabilities

  • Create persons via natural language
  • Query database through Claude
  • Update records with AI assistance
  • Delete operations safely

Architecture

  • MCP Server: Node.js with @modelcontextprotocol/sdk
  • Protocol: MCP (Model Context Protocol) v1.0
  • Database: Neon PostgreSQL via Prisma ORM
  • Client: Claude Desktop integration

Ready to Get Started?

Explore the source code, contribute, or deploy your own instance.