flux-dev-mcp-server

🚀 基于端脑云 Flux 模型 API 的 MCP 服务器实现

本项目依托端脑云的 Flux 模型 API，实现了一个 Model Context Protocol (MCP) 服务器，为用户提供强大的 AI 能力支持。

🚀 快速开始

本项目基于端脑云的 Flux 模型 API 实现了一个 MCP 服务器，为用户带来强大的 AI 能力。以下是快速上手步骤：

环境要求

• Node.js 16+ 版本
• npm 或 yarn 包管理工具
• Windows 或 MacOS 操作系统

安装依赖

# 适用于 Windows 和 MacOS 的通用命令
npm install

构建项目

# 适用于 Windows 和 MacOS 的通用命令
npm run build

开发模式

启动具有自动重新构建功能的开发模式：

# 适用于 Windows 和 MacOS 的通用命令
npm run watch

✨ 主要特性

• 强大技术栈：采用 TypeScript、Node.js 以及端脑云 API 构建，确保项目的高效与稳定。
• 跨平台支持：支持 Windows 和 MacOS 操作系统，方便不同用户使用。
• 便捷调试：推荐使用 MCP Inspector 工具进行调试，降低调试难度。

📦 安装指南

环境准备

确保你的环境满足以下要求：

• 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 路径请使用单正斜杠 /
• 请确保路径指向实际安装位置

🔧 技术细节

本项目采用的技术栈包括 TypeScript、Node.js 和端脑云 API。TypeScript 为项目提供了类型检查，增强了代码的可维护性；Node.js 作为运行环境，支持高效的服务器开发；端脑云 API 则为项目提供了强大的 AI 能力支持。

📄 许可证

本项目采用 MIT 许可证，具体内容请参阅 LICENSE 文件。

🎉 特别福利

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

🔧 调试指南

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

# 适用于 Windows 和 MacOS 的通用命令
npm run inspector

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

常见问题解答

1. Windows 系统权限问题

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

2. MacOS 系统权限问题

   • 如果出现 "Permission denied" 错误，请确保已正确设置文件执行权限：

     chmod +x build/index.js