flux-dev MCP 服务器

一个基于端脑云 Flux 模型 API 的 Model Context Protocol (MCP) 服务器实现。

本项目使用了端脑云的 API 服务，为用户提供强大的 AI 能力支持。

🎁 福利时间

使用我的邀请链接 https://cephalon.cloud/share/register-landing?invite_id=X46Dzv 或邀请码 X46Dzv 注册端脑云， 可以获得专属注册奖励，额外免费赠送 5000 端脑值！

技术栈

• TypeScript
• Node.js
• 端脑云 API

快速开始

环境要求

• Node.js 16+
• npm 或 yarn
• Windows 或 MacOS 系统

安装依赖

# Windows/MacOS 通用命令
npm install

构建项目

# Windows/MacOS 通用命令
npm run build

开发模式

启动带有自动重新构建的开发模式：

# Windows/MacOS 通用命令
npm run watch

Claude Desktop 配置说明

要在 Claude Desktop 中使用本服务器，需要添加服务器配置。配置文件位置因操作系统而异：

MacOS

配置文件路径：

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

Windows

配置文件路径：

%APPDATA%\Claude\claude_desktop_config.json

配置内容示例：

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"
    }
  }
}

注意：

• Windows 路径使用双反斜杠 \\ 或单正斜杠 /
• MacOS 路径使用单正斜杠 /
• 请确保路径指向实际安装位置

调试指南

由于 MCP 服务器通过标准输入输出（stdio）通信，调试可能会比较困难。我们推荐使用 MCP Inspector 工具：

# Windows/MacOS 通用命令
npm run inspector

Inspector 将提供一个浏览器访问地址，用于访问调试工具。

常见问题

1. Windows 系统权限问题

   • 如果遇到权限相关错误，请尝试以管理员身份运行命令提示符或 PowerShell

2. MacOS 系统权限问题

   • 如果遇到 "Permission denied" 错误，请确保已正确设置执行权限：

     chmod +x build/index.js
     

许可证

本项目采用 MIT 许可证，详见 LICENSE 文件。