AI导哈

模型上下文协议服务器

DreamFactory MCP是一个用于与Claude集成的模型上下文协议服务器，提供安全的企业数据访问和API管理功能。

  • by dreamfactorysoftware
  • TypeScript
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 dreamfactorysoftware/df-mcp

使用说明

梦工厂MCP

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

概述

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

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

开始使用DreamFactory的MCP服务器的最简单方法是转到此存储库的 发布 并下载最新的桌面扩展文件。 桌面扩展 是由Anthropic（Claude.ai背后的公司）创建的一种新的文件格式。下载后，双击DXT文件开始安装。请注意，您需要安装 克劳德桌面版 开始安装后，您将看到以下提示：

点击 Install 按钮，您将看到：

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

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

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

手动安装

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

    cd df-mcp
npm install

  2. 构建项目：

    npm run build

设置Claude桌面

  1. 从以下位置安装Claude Desktop https://claude.ai/download.

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

  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/<service-name>",
                "DREAMFACTORY_API_KEY": ""
            }
        }
    }
}

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

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

  8. 保存配置并重新启动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": "<URL>",
                "DREAMFACTORY_API_KEY": "<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/<service-name>",
        "--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.

相关 MCP