DreamFactory MCP

DreamFactory MCP

DreamFactory と Claude を連携するための Model Context Protocol（MCP）サーバーです。

概要

DreamFactory は、あらゆるデータソースへの統制された API アクセスを提供する、安全なセルフホスト型のエンタープライズ向けデータアクセスプラットフォームです。ロールベースのアクセス制御と ID パススルーにより、エンタープライズアプリケーションとオンプレミスの LLM を接続します。

デスクトップ拡張機能のインストール（Claude Desktop のみ）

DreamFactory の MCP サーバーを使い始める最も簡単な方法は、このリポジトリのリリースにアクセスし、最新のデスクトップ拡張機能ファイルをダウンロードすることです。デスクトップ拡張機能は、Anthropic（Claude.ai を提供する企業）が作成した新しいファイル形式です。ダウンロードしたら、DXT ファイルをダブルクリックしてインストールを開始します。事前にClaude Desktopをインストールしておく必要があります。インストールを開始すると、次のプロンプトが表示されます。

Install ボタンをクリックすると、次の画面が表示されます。

Install をクリックし、問題がなければ DreamFactory の API キーとサービス URL の入力を求められます。

この情報をすぐに確認できない場合は、Cancel をクリックしてください。後から、Settings 内の Extensions タブをクリックし、Configure をクリックして追加できます。

いずれの場合も、DreamFactory MCP サーバーを使用するには、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": ""
               }
           }
       }
   }
   

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 Version Manager）を使用している場合、インストールを妨げる分かりにくい問題が発生することがあります。Laravel Herd など、Node のパスにさらに変更を加える別の開発ツールも使用している場合、こうした問題がさらに複雑になることがあります。

MCP サーバーのログに、Claude Desktop が誤ったバージョンの Node を使用していると表示される場合は、次のようなシェルスクリプトを作成することで、使用するバージョンを簡単に指定できます。

#!/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 Desktop 向け Docker MCP のセットアップ

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://your-dreamfactory-instance.com/api/v2/<service-name>",
        "--env", "DREAMFACTORY_API_KEY=your-api-key-here",
        "dreamfactory-mcp:latest"
      ]
    }
  }
}

Claude Desktop の再起動

設定を更新した後、MCP サーバーを読み込むために Claude Desktop を再起動します。

Docker コンテナのテスト

付属のテストスクリプトを実行して、Docker のセットアップを検証します。

./test-docker.sh

これにより、コンテナが正しくビルドされ、MCP コマンドに応答し、すべてのツールが適切に登録されていることを確認できます。

開発

• ソースコードは src ディレクトリにあります
• ビルド済みファイルは build ディレクトリにあります
• npm start を使用して、ビルド済みサーバーを直接実行します

セキュリティ

セキュリティ上の問題を見つけた場合は、[email protected] までメールでご連絡ください。