MCP Demo

See the Person MCP Server in action with Claude Desktop

Setup Status

Pending Setup

To test the MCP server, follow the setup instructions to configure the Person App MCP server in Claude Desktop.

Interactive Demo Workflow

1

Create a Person

Ask Claude: "Create a new person named Alice Johnson, email alice@example.com, phone 555-0001, bio: Senior Developer"

Claude calls:
createPerson({
name: "Alice Johnson",
email: "alice@example.com",
phone: "555-0001",
bio: "Senior Developer"
})
2

Read All Persons

Ask Claude: "Show me all people in the database"

Claude calls:
readPerson()
3

Update a Person

Ask Claude: "Update person ID 1 to have bio: Principal Engineer with 10+ years experience"

Claude calls:
updatePerson({
id: 1,
bio: "Principal Engineer with 10+ years experience"
})
4

Delete a Person

Ask Claude: "Delete person with ID 2"

Claude calls:
deletePerson({ id: 2 })

MCP Architecture

┌─────────────────────────────────────────┐
│       Claude Desktop                    │
│     (with MCP Client)                   │
└──────────────────┬──────────────────────┘
                   │
                   │ MCP Protocol
                   ▼
┌─────────────────────────────────────────┐
│   Person App MCP Server                 │
│  (Node.js + @modelcontextprotocol/sdk)  │
│                                         │
│  Tools:                                 │
│  - createPerson                         │
│  - readPerson                           │
│  - updatePerson                         │
│  - deletePerson                         │
└──────────────────┬──────────────────────┘
                   │
                   │ Prisma ORM
                   ▼
┌─────────────────────────────────────────┐
│    Neon PostgreSQL Database             │
│  (Serverless, Auto-scaling)             │
└─────────────────────────────────────────┘

Troubleshooting

MCP Server not appearing in Claude

1. Check that the server is running
2. Verify the config file path is correct
3. Restart Claude Desktop completely
4. Check the Claude Desktop logs for errors

Database connection errors

1. Verify DATABASE_URL is set correctly
2. Use the pooled endpoint for serverless
3. Check network connectivity to Neon
4. Ensure the database exists and is accessible

Tool execution fails

1. Check Claude's error message
2. Verify the MCP server is running
3. Review the server logs
4. Ensure Prisma migrations are up to date

Next Steps

Full setup instructions and server deployment guide

View Setup GuideDatabase Schema