梦工厂MCP
用于DreamFactory与Claude集成的模型上下文协议（MCP）服务器。
概述
DreamFactory是一个安全的自托管企业数据访问平台，提供对任何数据源的受管理的API访问，通过基于角色的访问和身份传递连接企业应用程序和预处理LLM。
桌面扩展安装（仅限Claude Desktop）
点击 Install 按钮，您将看到：
点击 Install 如果一切顺利，系统将提示您输入DreamFactory API密钥和服务URL：
如果您没有现成的信息，只需单击 Cancel。您可以稍后通过单击“设置”中的“扩展”选项卡，然后单击 Configure:
在任何一种情况下，在使用DreamFactory MCP服务器之前，您都需要通过将Disabled开关翻转为Enabled来手动启用它：
手动安装
- 克隆此存储库，然后安装依赖项：
cd df-mcp
npm install- 构建项目：
npm run build设置Claude桌面
- 从以下位置安装Claude Desktop .
- 打开克劳德桌面并导航到设置。
- 在“设置”菜单中，转到“开发人员”部分。
- 点击“编辑配置”以修改Claude的配置。
- 添加以下配置以启用DreamFactory MCP服务器：
{
"mcpServers": {
"add": {
"command": "node",
"args": [
"/Users/dreamfactory/Documents/df-mcp/build/index.js"
],
"env": {
"DREAMFACTORY_URL": "https://example.dreamfactory.com/api/v2/",
"DREAMFACTORY_API_KEY": ""
}
}
}
}- 重要：修改路径
args阵列，以匹配您的本地安装路径（如果与/Users/dreamfactory/Documents/df-mcp/.
- 将您的DreamFactory URL和API密钥添加到
DREAMFACTORY_URLDREAMFACTORY_API_KEY根据需要设置环境变量。
- 保存配置并重新启动Claude Desktop。
关于Claude Desktop、NodeJS和NVM的说明
DreamFactory MCP需要节点22.10.0或更高版本。即使您正在运行Node 22.10或更高版本，如果您正在运行NVM（节点版本管理器），也可能会遇到一个令人困惑的问题，这会阻碍安装。有时，如果你额外使用其他开发工具，如Laravel Herd，对Node路径进行额外更改，这些问题会变得更加复杂。
如果MCP服务器日志显示Claude Desktop使用的Node版本错误，您可以通过创建一个类似于以下内容的shell脚本，轻松地强制它使用所需的版本：
#!/bin/zsh
source ~/.zshrc
exec /Applications/Herd/config/nvm/versions/node/v22.17.1/bin/node调用脚本 node-for-claude.sh 或类似，并将其放置 /usr/local/bin。然后使其可执行：
$ chmod +x node-for-claude.sh最后，更新 claude_desktop_config.json 指向此脚本的文件：
{
"mcpServers": {
"df-mcp": {
"command": "/usr/local/bin/node-for-claude.sh",
"args": [
"/Users/wjgilmore/Software/df-mcp/build/index.js"
],
"env": {
"DREAMFACTORY_URL": "",
"DREAMFACTORY_API_KEY": ""
}
}
}
}用法
配置后，DreamFactory MCP服务器将可供Claude Desktop使用。您可以通过Claude的界面使用DreamFactory的功能。
Claude桌面版Docker MCP设置
构建Docker镜像
docker build -t df-mcp .配置Claude桌面
将此配置添加到您的Claude Desktop配置文件中：
地点：
- macOS： ~/库/应用支持/Claude/Claude_desktop_config json
- 窗户： %APPDATA%\\Claude\\Claude_desktop_config json
- Linux： ~/.config/Claude/Claude_desktop_config json
配置
{
"mcpServers": {
"dreamfactory-mcp": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--env", "DREAMFACTORY_URL=https://your-dreamfactory-instance.com/api/v2/",
"--env", "DREAMFACTORY_API_KEY=your-api-key-here",
"dreamfactory-mcp:latest"
]
}
}
}重新启动克劳德桌面
更新配置后，重新启动Claude Desktop以加载MCP服务器。
测试Docker容器
运行附带的测试脚本以验证Docker设置：
./test-docker.sh这将验证容器是否正确构建，是否响应MCP命令，以及所有工具是否正确注册。
发展
- 源代码位于
src目录 - 内置文件位于
build目录 - 使用
npm start直接运行内置服务器
安全
发现安全问题？请发送电子邮件至security@dreamfactory.com.