DF MCP

梦工厂MCP

用于DreamFactory与Claude集成的模型上下文协议（MCP）服务器。

概述

DreamFactory是一个安全的自托管企业数据访问平台，提供对任何数据源的受管理的API访问，通过基于角色的访问和身份传递连接企业应用程序和预处理LLM。

桌面扩展安装（仅限Claude Desktop）

Claude Desktop Extension Prompt

点击 Install 按钮，您将看到：

Claude Desktop Extension Prompt #2

点击 Install 如果一切顺利，系统将提示您输入DreamFactory API密钥和服务URL：

Configuring your DreamFactory MCP Server

如果您没有现成的信息，只需单击 Cancel。您可以稍后通过单击“设置”中的“扩展”选项卡，然后单击 Configure:

Viewing your Extensions

在任何一种情况下，在使用DreamFactory MCP服务器之前，您都需要通过将Disabled开关翻转为Enabled来手动启用它：

Enabling the extension

手动安装

1. 克隆此存储库，然后安装依赖项：

   cd df-mcp
   npm install

1. 构建项目：

   npm run build

设置Claude桌面

1. 从以下位置安装Claude Desktop .

1. 打开克劳德桌面并导航到设置。

1. 在“设置”菜单中，转到“开发人员”部分。

1. 点击“编辑配置”以修改Claude的配置。

1. 添加以下配置以启用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": ""
               }
           }
       }
   }

1. 重要：修改路径 args 阵列，以匹配您的本地安装路径（如果与 /Users/dreamfactory/Documents/df-mcp/.

1. 将您的DreamFactory URL和API密钥添加到 DREAMFACTORY_URL DREAMFACTORY_API_KEY 根据需要设置环境变量。

1. 保存配置并重新启动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.