Flux Dev MCP Server

🚀 Implementation of MCP Server Based on Cephalon Cloud Flux Model API

This project implements a Model Context Protocol (MCP) server based on the Flux model API of Cephalon Cloud, providing users with powerful AI capabilities.

🎉 Special Offer

Register on Cephalon Cloud using my exclusive invitation link https://cephalon.cloud/share/register-landing?invite_id=X46Dzv or invitation code X46Dzv, and you'll get an additional 5000 Cephalon Points for free!

✨ Features

Technology Stack

• TypeScript
• Node.js
• Cephalon Cloud API

🚀 Quick Start

Environment Requirements

• Node.js version 16 or higher
• npm or yarn package manager
• Windows or MacOS operating system

📦 Installation

Install Dependencies

# Universal command for Windows and MacOS
npm install

Build the Project

# Universal command for Windows and MacOS
npm run build

Development Mode

Start the development mode with automatic rebuild functionality:

# Universal command for Windows and MacOS
npm run watch

📚 Documentation

Configuration Instructions for Claude Desktop

To use this server in Claude Desktop, you need to add the corresponding server configuration. The configuration file locations for different operating systems are as follows:

MacOS

Configuration file path:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Configuration file path:

%APPDATA%\Claude\claude_desktop_config.json

Configuration Content Example

Windows:

{
  "mcpServers": {
    "flux-dev": {
      "command": "C:\\path\\to\\flux-dev\\build\\index.js"
    }
  }
}

MacOS:

{
  "mcpServers": {
    "flux-dev": {
      "command": "/path/to/flux-dev/build/index.js"
    }
  }
}

⚠️ Important Note

• Use double backslashes \\ or single forward slashes / for Windows paths.
• Use single forward slashes / for MacOS paths.
• Ensure that the paths point to the actual installation locations.

Debugging Guide

Since the MCP server communicates via standard input and output (stdio), debugging can be challenging. We recommend using the MCP Inspector tool:

# Universal command for Windows and MacOS
npm run inspector

The Inspector will provide a browser access address for using the debugging tool.

Frequently Asked Questions

1. Windows System Permission Issues

   • If you encounter permission-related errors, try running the Command Prompt or PowerShell as an administrator.

2. MacOS System Permission Issues

   • If you get a "Permission denied" error, make sure you've correctly set the file execution permissions:

     chmod +x build/index.js
     

📄 License

This project is licensed under the MIT license. Please refer to the LICENSE file for specific details.