DollhouseMCP/mcp-server

View on GitHub ↗

A Free, Open Source MCP server for dynamic custom persona management with public a GitHub collection of personas, skills, templates, and other elements for AI models.

40 ★15 forksTypeScriptUpdated 18d ago

What you need to know

Open-source AI customization platform using modular elements (personas, skills, templates, agents, memories, ensembles) stored in a local portfolio. Uses MCP-AQL with 5 CRUDE endpoints for token efficiency, a server-side Gatekeeper permission system, agent execution loops and a browser-based setup wizard. Installable on any MCP-compatible client including Claude Code, Claude Desktop, Cursor, Gemini, Codex and local LLMs.

Install

npx @dollhousemcp/mcp-server@latest --web (interactive browser setup)
claude mcp add -s user dollhousemcp -- npx -y @dollhousemcp/mcp-server (Claude Code)
Download the .mcpb Desktop Extension for Claude Desktop one-click install

Usage

  • •Activate a starter element from the portfolio (~/.dollhouse/portfolio/)
  • •Describe any element type in plain English to create it
  • •Browse the community collection and install elements
  • •Ask the AI to 'activate the Dollhouse code review persona'

Key features

  • ✓6 element types: personas, skills, templates, agents, memories, ensembles
  • ✓MCP-AQL 5-endpoint CRUDE interface (~85% token reduction) with progressive disclosure introspection
  • ✓Server-side Gatekeeper permission system (deny > confirm > allow > route default)
  • ✓Agent execution loop with Gatekeeper checks, autonomy evaluator, Danger Zone and step recording
  • ✓37 bundled starter elements including the dollhouse-expert-suite ensemble
  • ✓Skills converter (bidirectional agent skills <-> Dollhouse Skills)
  • ✓Portfolio browser web console, GitHub sync, batch operations, universal backup, NLP discovery, cross-element GraphRAG-style relationships
  • ✓Windows/macOS/Linux across Node.js 20+

Best for

Users who want structured, permission-controlled AI customization across many clients

Caveats

  • ⚠AGPL-3.0-or-later license (network use requires source disclosure)
  • ⚠Advanced confirmation flows tested extensively on Claude Code; not rigorously verified on all platforms
  • ⚠Early/beta: v2.0.0 migration required from v1.x
Platforms: Windows · macOS · LinuxClients: Claude Code · Claude Desktop · Cursor · VS Code · Codex · Gemini CLI · Windsurf · Cline · LM Studio
Documentation ↗

Reviewed 2026-08-11

Topics

agentsaiai-toolsclaudecodexcursordollhousemcpensemblesllmmcpmcp-servermemorymodel-context-protocolpersonasprompt-engineeringskillstemplatestypescriptvscodewindsurf
Stars
40★
Forks
15
Language
TypeScript
License
AGPL-3.0
Created
2025-07-01
Last push
2026-08-17