SuperAPI AI 工具集

df-mcp

DreamFactory MCP(df-mcp)是一个基于 Model Context Protocol(MCP)的服务器,用于将 DreamFactory 平台与 Claude 集成。DreamFactory 是一个自托管的企业数据访问平台,可为任意数据源提供受治理的 API 访问,支持基于角色的访问控制(RBAC)和身份透传,连接企业应用与本地 LLM。该 MCP 服务器让 Claude 能够通过 DreamFactory 安全地访问本地及云端的 MS SQL Server、MySQL、PostgreSQL 等数据库和其他数据源。

访问官网

工具介绍

用途

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。

手动安装

  1. 克隆仓库并安装依赖:
    cd df-mcp
    npm install
    
  2. 构建项目:
    npm run build
    

配置 Claude Desktop

  1. 从 https://claude.ai/download 安装 Claude Desktop。
  2. 打开 Claude Desktop 并进入 Settings。
  3. 在 Settings 菜单中进入 "Developer" 部分。
  4. 点击 "Edit Config" 修改 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": ""
          }
        }
      }
    }
    
    重要:如果本地安装路径与 /Users/dreamfactory/Documents/df-mcp/ 不同,请修改 args 数组中的路径。
  6. 按需将 DreamFactory URL 和 API 密钥添加到 DREAMFACTORY_URL 和 DREAMFACTORY_API_KEY 环境变量中。
  7. 保存配置并重启 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。