Name: DreamFactory MCP
Author: dreamfactorysoftware

LABSCO SUMMARY

The access model lives in DreamFactory, not here.

That is the point of pairing them: the connector holds a key, and what that key can reach is decided by DreamFactory's roles and identity passthrough, so an assistant is bounded by the same policy as any other client. Two setup traps are documented and both are easy to hit — the extension ships disabled until you enable it, and an NVM-managed Node can leave Claude Desktop running the wrong version.

What it is

The official MCP server for DreamFactory, a self-hosted enterprise data-access platform that puts governed APIs in front of any data source with role-based access and identity passthrough. This connects that platform to Claude.

What you get

A Desktop Extension file from the repository's releases that installs into Claude Desktop by double-clicking, then prompts for your DreamFactory API key and service URL
Access scoped by the DreamFactory service you point it at — the URL includes the service name, so one connection targets one governed service
Role-based access and identity passthrough enforced by DreamFactory itself, not by the connector
A Docker path — build the image and run it with the URL and key passed as --env arguments

Requirements

A DreamFactory instance and an API key. Configuration is two environment variables: DREAMFACTORY_URL, which points at a specific service such as https://example.dreamfactory.com/api/v2/<service-name>, and DREAMFACTORY_API_KEY. Node 22.10.0 or newer is required — the README documents an NVM path problem where Claude Desktop picks up the wrong Node version, and gives a wrapper-script workaround. Install the DXT release, or clone and npm install then npm run build and point the config at build/index.js. After installing the extension you must flip its Disabled switch to Enabled before it works.

Setup effort

Build from source — git clone https://github.com/dreamfactorysoftware/df-mcp.git

See installation options

USE CASES

01

Querying a governed data source from a chat client

Point the URL at the DreamFactory service that already exposes it, so the roles you configured stay in force.

02

Installing without touching a config file

Download the Desktop Extension from releases, double-click, enter the key and URL when prompted — then enable it in Settings.

03

Getting past a Node version mismatch

Point the client at a small shell script that execs the Node version you want, as the README shows, when NVM sends Claude Desktop to the wrong one.

04

Running it isolated from your local Node

Build the Docker image and pass the URL and key as environment arguments in the client config.

BEFORE YOU INSTALL

What to know first

Requires

Node.js 22.10.0 or newer
A DreamFactory instance: DREAMFACTORY_URL (its service API URL) and DREAMFACTORY_API_KEY

INSTALLATION

Connect your client

You clone and build this one yourself.

Server setup

TERMINAL

git clone https://github.com/dreamfactorysoftware/df-mcp.git
cd df-mcp
npm install
npm run build

MCP Clients

Claude Desktop — Extension

Download the latest .dxt Desktop Extension file from https://github.com/dreamfactorysoftware/df-mcp/releases (currently df-mcp-v1.0.1.dxt).

Double-click the file and click Install at both prompts, then enter your DreamFactory API key and service URL when asked (or Cancel and add them later under Settings → Extensions → Configure).

Flip the extension's switch from Disabled to Enabled before you use it.

Claude Desktop — Docker

In your clone from the steps above, build the image:

CLAUDE DESKTOP — DOCKER · TERMINAL

docker build -t df-mcp .

CLAUDE DESKTOP — DOCKER · JSON

{
  "mcpServers": {
    "dreamfactory-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env",
        "DREAMFACTORY_URL=<YOUR_DREAMFACTORY_URL>/api/v2/<YOUR_SERVICE_NAME>",
        "--env",
        "DREAMFACTORY_API_KEY=<YOUR_DREAMFACTORY_API_KEY>",
        "df-mcp"
      ]
    }
  }
}

Claude Desktop — local build

CLAUDE DESKTOP — LOCAL BUILD · JSON

{
  "mcpServers": {
    "df-mcp": {
      "command": "node",
      "args": [
        "/Users/dreamfactory/Documents/df-mcp/build/index.js"
      ],
      "env": {
        "DREAMFACTORY_URL": "https://example.dreamfactory.com/api/v2/<YOUR_SERVICE_NAME>",
        "DREAMFACTORY_API_KEY": "<YOUR_DREAMFACTORY_API_KEY>"
      }
    }
  }
}

/Users/dreamfactory/Documents/df-mcp is a sample path; yours is the absolute path of your clone. Restart Claude Desktop afterwards. The server needs Node 22.10.0 or newer.

DreamFactory MCP