mcp

DollhouseMCP is a Node.js-based MCP server that powers the Dollhouse customization ecosystem. It exposes a server you can run to host and manage customization elements such as personas, skills, templates, agents, and memories, enabling developers and creators to deploy and share AI customization configurations via the MCP (Model Context Protocol). Once running, you can leverage the built-in element library, create new elements from natural language prompts, validate them with the security-focused tooling, and swap elements on the fly for experiments and deployment. The server is designed to integrate with the DollhouseMCP Collection and the broader ecosystem, allowing elements to be installed from the collection and shared back for collaboration. Tools include a CLI workflow for creating and editing elements, a collection-driven install experience, and support for hot-swap updates to reduce downtime during experimentation and refinement.

Prerequisites:

• Node.js (LTS version) and npm installed on your system
• Access to the internet to fetch the npm package

Installation steps:

1. Install Node.js and npm from https://nodejs.org if you do not already have them.

2. Install or run the MCP server via npx (no persistent global install required):

   npm privacy=false # optional: ensure npm config if needed npx -y @dollhousemcp/mcp-server

   This will fetch the package and start the server according to its default configuration. If you prefer a persistent global install, you can install the package globally and run it from the CLI:

   npm install -g @dollhousemcp/mcp-server mcp-server

3. (Optional) Explore configuration options and environment variables as described in the project documentation to customize ports, hosts, and security settings.

4. Verify the server is running by checking the console output or visiting the configured MCP endpoint URL in your browser or MCP client.

Notes and tips:

• This server is AGPL-3.0 licensed and aims to be community-powered via the DollhouseMCP Collection.
• Environment variables and configuration options can typically control network binding, collection paths, and security validations; consult the repository docs for exact names.
• If you encounter network or authentication issues, ensure your firewall allows the chosen port and that any required credentials or tokens for the DollhouseMCP Collection are correctly configured.
• The npm package name to reference in configurations is @dollhousemcp/mcp-server; use npx @dollhousemcp/mcp-server to run without installing.
• When using npx, the first run may download dependencies; subsequent runs will be faster due to caching.