https://github.com/dreamfactorysoftware/df-mcp-server
DreamFactory is a self-hosted platform providing governed API access to any data source for enterprise apps and local LLMs.
https://github.com/dreamfactorysoftware/df-mcp-server
Last synced: 4 days ago
JSON representation
DreamFactory is a self-hosted platform providing governed API access to any data source for enterprise apps and local LLMs.
- Host: GitHub
- URL: https://github.com/dreamfactorysoftware/df-mcp-server
- Owner: dreamfactorysoftware
- Created: 2025-10-30T10:59:49.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-05-13T00:58:16.000Z (about 1 month ago)
- Last Synced: 2026-05-13T02:35:18.146Z (about 1 month ago)
- Language: PHP
- Size: 345 KB
- Stars: 1
- Watchers: 0
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## DreamFactory MCP Service
> **Note:** This repository contains the mcp service features of the DreamFactory platform. If you want the full DreamFactory platform, visit the main [DreamFactory repository](https://github.com/dreamfactorysoftware/dreamfactory).
## Overview
DreamFactory is a secure, self-hosted enterprise data access platform that provides governed API access to any data source, connecting enterprise applications and on-prem LLMs with role-based access and identity passthrough.
## Installation
Edit your project’s composer.json to require the following package.
“require”:{
"dreamfactory/df-mcp-server": "~1.1.0"
}
Save your composer.json and do a "composer update" to install the package.
### MCP Daemon process
The Laravel package proxies every MCP request through a persistent Node.js daemon that keeps long-lived MCP server instances warm.
1. Install dependencies
```
cd daemon
npm install
```
2. Configure the daemon host/port (or use defaults) and point DreamFactory to it by adding the following to your `.env` file:
```
MCP_DAEMON_ENABLED=true
MCP_DAEMON_URL=http://127.0.0.1:8006
```
3. Start the daemon (choose the mode you need):
```
# Development
npm run dev
# Production
npm start
```
Once the daemon is online, the MCP routes in DreamFactory automatically forward traffic to it.
### Authentication
The MCP service uses OAuth-based authentication. Users must authenticate with DreamFactory via OAuth to obtain a session token. The Laravel controller validates requests and passes the session token to the daemon via the `X-DreamFactory-Session-Token` header.
See `daemon/README.md` for advanced options, available tools, and management endpoints.
## Feedback and Contributions
* Feedback is welcome in the form of pull requests and/or issues.
* Contributions should generally follow the strategy outlined in ["Contributing to a project"](https://help.github.com/articles/fork-a-repo#contributing-to-a-project)
* All pull requests must be in a ["git flow"](https://github.com/nvie/gitflow) feature branch and formatted as [PSR-2 compliant](http://www.php-fig.org/psr/psr-2/) to be considered.
### License
The DreamFactory scripting script repository is open-sourced software available for use under the [Apache Version 2.0 license](http://www.apache.org/licenses/LICENSE-2.0).