用途
DreamFactory MCP 是一个 Model Context Protocol(MCP)服务器,用于将 DreamFactory 与 Claude 集成。DreamFactory 本身是一个安全、自托管的企业数据访问平台,为任意数据源提供受治理的 API 访问,连接企业应用与本地 LLM,并具备基于角色的访问控制(RBAC)和身份透传能力。通过该 MCP 服务器,用户可以在 Claude 界面中使用 DreamFactory 的能力,安全地访问本地及云端的 MS SQL Server、MySQL、PostgreSQL 数据库和其他数据源。
主要能力
- 作为 MCP 服务器,将 DreamFactory 集成到 Claude 中。
- 依托 DreamFactory 平台,提供对任意数据源的受治理 API 访问。
- 支持基于角色的访问控制(RBAC)与身份透传。
- 可连接企业应用与本地 LLM。
- 支持通过环境变量配置 DreamFactory 服务 URL 与 API 密钥。
使用方式
桌面扩展安装(仅限 Claude Desktop)
最简单的方式是前往该仓库的 releases 页面,下载最新的 Desktop Extension 文件(DXT 格式,由 Anthropic 创建)。下载后双击 DXT 文件开始安装,需先安装 Claude Desktop。安装过程中会提示输入 DreamFactory API 密钥和服务 URL;若暂无此信息可点击 Cancel,之后可在 Settings 的 Extensions 标签中点击 Configure 添加。无论哪种情况,使用前都需手动将 Disabled 开关切换为 Enabled。
手动安装
- 克隆仓库并安装依赖:
cd df-mcp npm install - 构建项目:
npm run build
配置 Claude Desktop
- 从 https://claude.ai/download 安装 Claude Desktop。
- 打开 Claude Desktop 并进入 Settings。
- 在 Settings 菜单中进入 "Developer" 部分。
- 点击 "Edit Config" 修改 Claude 配置。
- 添加以下配置以启用 DreamFactory MCP 服务器:
重要:如果本地安装路径与 /Users/dreamfactory/Documents/df-mcp/ 不同,请修改 args 数组中的路径。{ "mcpServers": { "add": { "command": "node", "args": [ "/Users/dreamfactory/Documents/df-mcp/build/index.js" ], "env": { "DREAMFACTORY_URL": "https://example.dreamfactory.com/api/v2/<service-name>", "DREAMFACTORY_API_KEY": "" } } } } - 按需将 DreamFactory URL 和 API 密钥添加到 DREAMFACTORY_URL 和 DREAMFACTORY_API_KEY 环境变量中。
- 保存配置并重启 Claude Desktop。
关于 Claude Desktop、NodeJS 与 NVM 的说明
DreamFactory MCP 需要 Node 22.10.0 或更新版本。即使运行的是 Node 22.10 或更新版本,如果使用 NVM(Node Version Manager)也可能遇到安装受阻的问题。若同时使用 Laravel Herd 等会修改 Node 路径的其他开发工具,问题可能更复杂。如果 MCP 服务器日志显示 Claude Desktop 使用了错误的 Node 版本,可以创建一个 shell 脚本强制其使用所需版本,将脚本命名为 node-for-claude.sh 或类似名称,放在 /usr/local/bin 中,然后使其可执行,最后更新 claude_desktop_config.json 文件指向该脚本。配置完成后,DreamFactory MCP 服务器即可在 Claude Desktop 中使用。
Docker MCP 设置(适用于 Claude Desktop)
构建 Docker 镜像后,将以下配置添加到 Claude Desktop 配置文件中:
- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%APPDATA%\Claude\claude_desktop_config.json
- Linux:~/.config/Claude/claude_desktop_config.json
更新配置后重启 Claude Desktop 以加载 MCP 服务器。可运行包含的测试脚本来验证 Docker 设置,确认容器正确构建、响应 MCP 命令且所有工具正确注册。
源码与构建
- 源代码位于 src 目录。
- 构建文件位于 build 目录。
- 使用 npm start 直接运行构建后的服务器。
适用场景
- 企业应用与本地 LLM 的数据连接。
- 通过 Claude 安全访问本地及云端的 MS SQL Server、MySQL、PostgreSQL 等数据库和其他数据源。
- 需要基于角色访问控制与身份透传的受治理数据访问场景。
限制
- 桌面扩展安装方式仅限 Claude Desktop。
- 需要 Node 22.10.0 或更新版本。
- 使用 NVM 或 Laravel Herd 等工具时可能遇到 Node 路径相关问题。
- 使用前需配置 DreamFactory API 密钥和服务 URL。
- 其他收费、价格、平台支持等具体信息暂未提供。
安全
如发现安全问题,可发送邮件至 security@dreamfactory.com。