适合谁
- 希望用可组合、可共享元素深度定制 AI 行为的高级用户
- 关注权限治理与可审计代理执行的安全敏感团队
- Claude Code 等支持完整工具调用回传的 MCP 客户端用户
D
61FMRS · C
一个工程化程度高、安全设计突出的 AI 定制 MCP 服务器：MCP-AQL 的 5 端点设计显著节省 token，服务端 Gatekeeper 与危险区机制提供了客户端之外的权限兜底。亮点是本地优先的元素组合体系与活跃的社区集合；需留意第三方元素审查、Claude Desktop 权限钩子不完整及 AGPL-3.0 合规要求。测试覆盖广（9600+ 测试），跨平台支持完善。
DollhouseMCP 是一个免费开源的 MCP 服务器，用于通过模块化元素（角色、技能、模板、代理、记忆、组合）动态定制 AI 行为。所有元素以 Markdown/YAML 文件存储在本地组合目录（~/.dollhouse/portfolio/），自带 37 个初始元素，并可选同步到 GitHub 或安装社区集合中的元素。它采用 MCP-AQL 设计，将操作归并为 5 个语义端点（Create/Read/Update/Delete/Execute），并通过服务端 Gatekeeper 强制执行元素级权限策略：即使 MCP 客户端设置为始终允许，deny 规则也无法被绕过。代理执行经过自主性评估、危险区拦截与步骤审计。支持 Claude Code、Claude Desktop、Cursor、Gemini、Codex、VS Code、Windsurf、Cline、LM Studio 等客户端，基于 TypeScript，遵循 AGPL-3.0 许可证。
工具能力
mcp_aql_read
读取端点：列出、搜索、查看、激活元素及内省操作，自动批准、无副作用。
mcp_aql_create
创建端点：新建元素、从集合安装、添加记忆条目，每会话确认一次。
mcp_aql_update
更新端点：编辑现有元素，每次操作需确认。
mcp_aql_delete
删除端点：移除元素、清空条目，每次操作需确认。
mcp_aql_execute
执行端点：运行代理、管理执行生命周期、确认受控操作。
convert_skill_format
在 Dollhouse Skills 与 Claude/Anthropic agent skills 格式之间进行双向无损转换。
open_portfolio_browser
打开内置网页组合浏览器，可视化浏览和管理元素。
安装接入
1) 交互式安装：运行 npx @dollhousemcp/mcp-server@latest --web，在浏览器向导中一键安装到 Claude Desktop、Claude Code、Cursor、VS Code、Codex、Gemini CLI、Windsurf、Cline 或 LM Studio；2) Claude Code 一条命令：claude mcp add -s user dollhousemcp -- npx -y @dollhousemcp/mcp-server；3) Claude Desktop：下载 .mcpb 桌面扩展并双击安装；4) 也可本地安装 npm install @dollhousemcp/mcp-server 后将客户端指向 dist/index.js。可通过 MCP_AQL_ENDPOINT_MODE、MCP_INTERFACE_MODE、DOLLHOUSE_PORTFOLIO_DIR、GITHUB_TOKEN 等环境变量配置。
claude_desktop_config.json
{"mcpServers":{"dollhousemcp":{"command":"npx","args":["-y","@dollhousemcp/mcp-server"]}}}
选型与风险
不适合谁
- 需要由上游产品官方维护的服务器的用户（本项目为社区独立项目）
- 主要依赖 Claude Desktop 原生权限钩子流程的用户（该版本无原生支持）
- 希望零配置、无需了解元素与权限模型即可获得完整体验的初学者
所需权限
- 读写 ~/.dollhouse/portfolio/ 中的本地 Markdown/YAML 元素文件
- 可选使用 GITHUB_TOKEN 进行 GitHub 组合同步与社区提交
- 写/删/执行类 MCP-AQL 操作默认需逐次确认（可在策略允许时自动批准）
- 代理执行可能触发文件删除、外部 API 调用、系统命令等高风险操作，受危险区拦截与自主性评估约束
风险与副作用
- 激活的元素会即时改变 AI 可用工具与权限，误激活限制性元素会阻塞操作
- 社区集合中的第三方元素可能包含不当内容或策略，安装前应审查
- 代理可自主执行多步骤任务，虽有危险区与审计，仍需人工监督
- AGPL-3.0 要求网络使用时公开源代码，商用集成需注意合规
常见排障
- 确认元素位于 DOLLHOUSE_PORTFOLIO_DIR 指定的组合目录且格式正确（YAML frontmatter）
- 操作被拒绝时检查当前激活元素的 Gatekeeper allow/deny/confirm 策略，deny 无法被客户端覆盖
- 确认 MCP_AQL_ENDPOINT_MODE 与 MCP_INTERFACE_MODE 设置符合期望的工具暴露方式（crude/single/discrete）
- 重启后激活状态丢失则检查激活持久化与本地文件写入权限
- GitHub 同步失败时检查 GITHUB_TOKEN 权限；更多方案见官方 Troubleshooting 文档
使用场景
用自然语言创建并激活角色、技能、模板、代理或记忆来改变 AI 行为
以只读分析角色等元素限制 AI 的操作权限（服务端强制）
运行多步骤 Dollhouse 代理并保留完整审计记录
通过 GitHub 备份组合并在多台机器间同步、向社区贡献元素
用单个组合元素打包多个角色/技能实现一键切换工作模式
支持客户端
Claude Code完整支持
Claude Desktop部分支持
Cursor部分支持
VS Code部分支持
Codex部分支持
Gemini CLI部分支持
Windsurf部分支持
Cline部分支持
LM Studio部分支持