personas-mcp 0.1.0

MCP server for NVIDIA personas database

Personas MCP Server

An MCP (Model Context Protocol) server that provides access to the NVIDIA personas database through various tools.

Features

The server exposes the following tools:

• get_random_persona: Retrieve a random persona from the database
• get_persona_by_id: Get a specific persona by UUID
• search_personas: Search personas by various criteria (age, sex, state, occupation, education, etc.)
• get_persona_stats: Get statistics about the personas database

Installation and Usage

This MCP server is designed to be run with uvx:

# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# From the personas-mcp directory
uvx --from . personas-mcp

# Or from the parent personas directory
uvx --from ./personas-mcp personas-mcp

Configuration for Claude Desktop

Add this to your Claude Desktop configuration file:

macOS

Location: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Location: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "personas": {
      "command": "uvx",
      "args": ["--from", "/path/to/personas-mcp", "personas-mcp"]
    }
  }
}

Make sure to replace /path/to/personas-mcp with the actual path to the personas-mcp directory.

Tool Usage Examples

Get Random Persona

Use the get_random_persona tool

Search Personas

Use the search_personas tool with:
- age_min: 25
- age_max: 35
- state: "CA"
- limit: 5

Get Persona by ID

Use the get_persona_by_id tool with:
- uuid: "df6b2b96-a938-48b0-83d8-75bfed059a3d"

Get Database Statistics

Use the get_persona_stats tool

Development

The server expects the personas.parquet file to be in the parent directory (relative to the personas-mcp folder). If the file is not found, it will automatically download it from the NVIDIA Nemotron-Personas dataset on Hugging Face.

Directory structure:

personas/
├── personas.parquet (auto-downloaded if missing)
├── personas-mcp/
│   ├── src/
│   │   └── server.py
│   ├── pyproject.toml
│   └── README.md

Auto-download Feature

If personas.parquet is not found, the server will automatically download it from: https://huggingface.co/datasets/nvidia/Nemotron-Personas/

The download is approximately 37MB and will show progress during download.