DreamFactory MCP

这是一个用于DreamFactory与Claude集成的Model Context Protocol (MCP)服务器。

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

开始使用DreamFactory的MCP服务器最简单的方法是访问此仓库的发布页面，并下载最新的桌面扩展文件。桌面扩展是由Anthropic公司（Claude.ai背后的公司）创建的一种新的文件格式。下载后，双击DXT文件以开始安装。请注意，在进行此操作之前，您需要先安装Claude Desktop。启动安装后，您会看到以下提示：

点击安装按钮，您会看到：

点击安装，如果一切顺利，您会被提示输入DreamFactory API密钥和服务URL：

如果您没有这些信息，只需点击取消。您可以在稍后通过点击设置中的“扩展”标签，然后点击配置来添加它：

无论哪种情况，在您可以使用DreamFactory MCP服务器之前，都需要手动启用它，即将禁用开关切换到启用状态：

手动安装

1. 克隆此仓库并安装依赖项：

   cd df-mcp
   npm install
   

2. 构建项目：

   npm run build
   

设置Claude Desktop

1. 从https://claude.ai/download安装Claude Desktop。

2. 打开Claude Desktop并导航至设置。

3. 在设置菜单中，转到“开发者”部分。

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

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

6. 重要：如果您的本地安装路径不同于/Users/dreamfactory/Documents/df-mcp/，请修改args数组中的路径。

7. 将您的DreamFactory URL和API密钥添加到环境变量DREAMFACTORY_URL和DREAMFACTORY_API_KEY中。

8. 保存配置并重启Claude Desktop。

关于Claude Desktop、NodeJS和NVM的注意事项

DreamFactory MCP需要Node 22.10.0或更高版本。即使您正在运行Node 22.10或更高版本，如果您使用的是NVM（Node版本管理器），可能会遇到妨碍安装的混淆问题。如果还使用了其他开发工具如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": "<URL>",
                "DREAMFACTORY_API_KEY": "<API_KEY>"
            }
        }
  }
}

使用方法

配置完成后，DreamFactory MCP服务器将在Claude Desktop中可用。您可以通过Claude的界面使用DreamFactory的功能。

Docker MCP设置用于Claude Desktop

构建Docker镜像

docker build -t df-mcp .

配置Claude Desktop

将此配置添加到您的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

配置

{
  "mcpServers": {
    "dreamfactory-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env", "DREAMFACTORY_URL=https://您的DreamFactory实例.com/api/v2/<服务名称>",
        "--env", "DREAMFACTORY_API_KEY=您的API密钥",
        "dreamfactory-mcp:latest"
      ]
    }
  }
}

重启Claude Desktop

更新配置后，重启Claude Desktop以加载MCP服务器。

测试Docker容器

运行包含的测试脚本来验证Docker设置：

./test-docker.sh

这将验证容器是否构建正确，响应MCP命令，并且所有工具都已正确注册。

开发

• 源代码位于src目录
• 构建文件位于build目录
• 使用npm start直接运行构建的服务器

安全

发现安全问题？请发送邮件至security@dreamfactory.com。