MCP Server Setup Guide

Enable Person CRUD operations in Claude Desktop using our MCP server

What is the Person MCP Server?

The Person MCP Server enables Claude Desktop to perform full CRUD operations on your Person database directly through MCP tools. No API calls needed — Claude can create, read, update, and delete person records with natural language.

Prerequisites

Claude Desktop

Latest version installed on your machine

Node.js 20.9+

For running the MCP server locally

DATABASE_URL

Neon PostgreSQL connection string (pooled endpoint)

Installation Steps

1

Clone MCP Server Repository

Get the MCP server code from GitHub:

git clone https://github.com/jeneya-cabildo/jenesaorquesta-person-app-mcp.git
cd jenesaorquesta-person-app-mcp
2

Install Dependencies

Install Node.js dependencies:

pnpm install
3

Configure Environment

Create .env.local with your database URL:

DATABASE_URL="postgresql://user:password@host-pooler.neon.tech/dbname"
4

Add to Claude Desktop Configuration

Edit your Claude Desktop config file:

macOS/Linux: ~/.config/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this configuration (replace with your path):

{
  "mcpServers": {
    "person-app": {
      "command": "node",
      "args": ["/path/to/jenesaorquesta-person-app-mcp/dist/index.js"],
      "env": {
        "DATABASE_URL": "postgresql://user:password@host-pooler.neon.tech/dbname"
      }
    }
  }
}
5

Restart Claude Desktop

Quit and restart Claude Desktop. You should now see the Person App MCP server available in Claude.

Available MCP Tools

createPerson

Create a new person record

name (string), email (string), phone? (string), address? (string), bio? (string)

readPerson

Get person records by ID or list all

id? (number) — omit to list all persons

updatePerson

Update an existing person record

id (number), name? (string), email? (string), phone? (string), address? (string), bio? (string)

deletePerson

Delete a person record by ID

id (number)

Example Claude Prompts

"Create a new person named John Doe with email john@example.com and phone 555-1234"

"Show me all people in the database"

"Update person with ID 1 to change their email to newemail@example.com"

"Delete the person with ID 5"

Ready to Test?

Try the MCP server in action with our interactive demo