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