DollhouseMCP
๐ ๐ ๐ ๐ช ๐ง - One-line installable MCP server that adds reusable customization elements โ personas, skills, t
What is DollhouseMCP?
DollhouseMCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐ ๐ ๐ ๐ช ๐ง - one-line installable mcp server that adds reusable customization elements โ personas, skills, t
๐ ๐ ๐ ๐ช ๐ง - One-line installable MCP server that adds reusable customization elements โ personas, skills, t
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP protocol support
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @dollhousemcp/mcp-serverManual Installation
npx -y @dollhousemcp/mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use DollhouseMCP
DollhouseMCP is a one-line installable MCP server that adds reusable customization elements โ personas, skills, templates, agents, prompts, and ensembles โ to any MCP-compatible AI client including Claude Desktop, Claude Code, Cursor, VS Code, Codex, Gemini CLI, Windsurf, Cline, and LM Studio. It ships with 37 starter elements and a dedicated dollhouse-expert-suite ensemble, letting developers define named behavior patterns they can activate and reuse across sessions without re-prompting. Operations use a semantic MCP-AQL query language through five endpoints (Create, Read, Update, Delete, Execute) with auto-approval for read-only actions.
Prerequisites
- Node.js 18 or later (for npx execution)
- An MCP-compatible client such as Claude Desktop, Claude Code, Cursor, or VS Code
- Optional: a GitHub personal access token (GITHUB_TOKEN) for publishing custom elements to a GitHub-backed portfolio
- Optional: write access to ~/.dollhouse/portfolio/ for persistent custom element storage
Run the interactive setup wizard
The easiest installation path is the browser-based wizard, which detects your installed MCP clients and adds the server configuration automatically with one click.
npx @dollhousemcp/mcp-server@latest --webOr add directly to Claude Code
For Claude Code users, the single-line CLI command registers DollhouseMCP as a user-scoped MCP server without opening a browser.
claude mcp add -s user dollhousemcp -- npx -y @dollhousemcp/mcp-serverConfigure Claude Desktop manually
For Claude Desktop, add the server entry to claude_desktop_config.json. No API keys are required for basic operation.
{
"mcpServers": {
"dollhousemcp": {
"command": "npx",
"args": ["-y", "@dollhousemcp/mcp-server"],
"env": {
"DOLLHOUSE_PORTFOLIO_DIR": "~/.dollhouse/portfolio/"
}
}
}
}Explore available elements
After connecting your client, ask DollhouseMCP to list all available elements. The 37 starter elements include personas, skills, and ensembles you can activate immediately.
Activate a persona or ensemble
Use natural language to activate a persona or the expert suite ensemble. DollhouseMCP's Read operations are auto-approved, so listing and activating elements requires no confirmation prompts.
DollhouseMCP Examples
Client configuration (claude_desktop_config.json)
Full configuration block for Claude Desktop with optional GitHub token for portfolio sync and custom portfolio directory.
{
"mcpServers": {
"dollhousemcp": {
"command": "npx",
"args": ["-y", "@dollhousemcp/mcp-server"],
"env": {
"DOLLHOUSE_PORTFOLIO_DIR": "/Users/you/.dollhouse/portfolio/",
"GITHUB_TOKEN": "ghp_yourtoken",
"MCP_INTERFACE_MODE": "mcpaql"
}
}
}
}Prompts to try
Example prompts for exploring and using DollhouseMCP personas, skills, and ensembles.
- "What DollhouseMCP elements do you have available?"
- "Activate the code review persona"
- "List all available Dollhouse skills"
- "Activate the dollhouse-expert-suite ensemble to help me set up DollhouseMCP"
- "Create a new persona named 'TechWriter' that responds in concise, documentation-friendly language"
- "Show me all active elements in my current Dollhouse session"Troubleshooting DollhouseMCP
npx -y @dollhousemcp/mcp-server fails with version resolution errors
Clear the npx cache with `npm cache clean --force` and retry. If behind a corporate proxy, set the npm proxy: `npm config set proxy http://proxy.example.com:8080`. You can also pin a specific version by replacing @dollhousemcp/mcp-server with @dollhousemcp/mcp-server@<version>.
Portfolio changes are not persisted between sessions
Ensure DOLLHOUSE_PORTFOLIO_DIR points to a writable directory and that the path uses an absolute value rather than a tilde (~). On macOS/Linux the default is ~/.dollhouse/portfolio/; on Windows use %USERPROFILE%\.dollhouse\portfolio\. Create the directory manually if it does not exist: `mkdir -p ~/.dollhouse/portfolio`.
Update and Delete operations keep prompting for confirmation
This is expected behavior โ DollhouseMCP auto-approves only Read operations (list, search, activate). Write operations (Update, Delete, Execute) require explicit user confirmation to prevent accidental data loss. Add frequently used operations to your MCP client's allowed tools list if you want to reduce prompts.
Frequently Asked Questions about DollhouseMCP
What is DollhouseMCP?
DollhouseMCP is a Model Context Protocol (MCP) server that ๐ ๐ ๐ ๐ช ๐ง - one-line installable mcp server that adds reusable customization elements โ personas, skills, t It connects AI assistants to external tools and data sources through a standardized interface.
How do I install DollhouseMCP?
Install via npm with the command: npx -y @dollhousemcp/mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with DollhouseMCP?
DollhouseMCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is DollhouseMCP free to use?
Yes, DollhouseMCP is open source and available under the AGPL-3.0 license. You can use it freely in both personal and commercial projects.
DollhouseMCP Alternatives โ Similar Developer Tools Servers
Looking for alternatives to DollhouseMCP? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
โ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
โ 155.8kJava ้ข่ฏ & ๅ็ซฏ้็จ้ข่ฏๆๅ๏ผ่ฆ็่ฎก็ฎๆบๅบ็กใๆฐๆฎๅบใๅๅธๅผใ้ซๅนถๅใ็ณป็ป่ฎพ่ฎกไธ AI ๅบ็จๅผๅ
Gemini CLI
โ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
โ 87.3kโญ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
โ 86.0kModel Context Protocol Servers
CC Switch
โ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up DollhouseMCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use DollhouseMCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.