Flix MCP Server
🚀 MCP (Model Context Protocol) 服务器实现，为 Flix 局域网文件传输应用提供 AI 模型调用接口。
✨ 特性亮点
- 🔍 设备发现 - 自动发现局域网内的 Flix 设备
- 📨 消息传输 - 发送/接收文本消息
- 📁 文件传输 - 支持断点续传的文件收发
- 📋 剪贴板同步 - 跨设备剪贴板同步
- 🔒 设备管理 - 设备配对、黑名单管理
- 🤖 AI 集成 - 与 Claude Desktop 等 AI 客户端无缝集成
📦 快速开始
安装和构建
# 克隆项目
git clone
cd flix-mcp
# 安装依赖
npm install
# 构建项目
npm run build
# 启动服务
npm start验证运行
# 检查健康状态
curl http://localhost:8765/health
# 预期输出
{"status":"ok","deviceId":"...","deviceName":"Flix MCP Server"}配置
创建 .env 文件：
# 服务配置
PORT=8765
DEVICE_NAME=Flix MCP Server
# 文件传输配置
MAX_FILE_SIZE=10737418240 # 10GB
AUTO_RECEIVE=false
DOWNLOAD_DIR=./downloads
# 安全配置
REQUIRE_PAIRING=true🤖 与 Claude Desktop 集成
在 Claude Desktop 配置文件中添加：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"flix": {
"command": "node",
"args": ["/absolute/path/to/flix-mcp/dist/index.js"],
"env": {
"DEVICE_NAME": "Claude Flix",
"AUTO_RECEIVE": "true"
}
}
}
}重启 Claude Desktop 后，你就可以：
用户: 发现局域网内的 Flix 设备
Claude: [调用 flix_discover_devices 工具]
用户: 把文件 ~/Documents/report.pdf 发送到我的 iPad
Claude: [调用 flix_send_file 工具]
用户: 同步剪贴板到我的 iPhone
Claude: [调用 flix_sync_clipboard 工具]MCP Tools
设备管理
flix_discover_devices- 发现局域网设备flix_get_device- 获取设备详情flix_pair_device- 设备配对flix_block_device- 拉黑设备flix_unblock_device- 解除拉黑
消息传输
flix_send_text- 发送文本消息flix_get_messages- 获取消息列表
文件传输
flix_send_file- 发送文件flix_receive_file- 接收文件flix_get_transfer_status- 查询传输状态flix_cancel_transfer- 取消传输flix_pause_transfer- 暂停传输flix_resume_transfer- 恢复传输
剪贴板同步
flix_sync_clipboard- 同步剪贴板flix_get_clipboard- 获取剪贴板内容
📚 文档
🛠️ 开发
# 开发模式（自动重载）
npm run dev
# 运行测试
npm test
# 代码检查
npm run lint
# 构建
npm run build🐳 Docker 部署
# 使用 Docker Compose（推荐）
docker-compose up -d
# 或手动构建
docker build -t flix-mcp .
docker run -d --network host -v $(pwd)/downloads:/app/downloads flix-mcp注意: 使用 --network host 以支持 UDP 组播发现。
📊 项目状态
✅ 完全实现 - 所有核心功能已完成 ✅ 生产就绪 - 完善的错误处理和测试 ✅ 文档完善 - 详细的使用文档和示例 ✅ 构建成功 - TypeScript 编译通过
🤝 贡献
欢迎提交 Issue 和 Pull Request！
📄 许可证
MIT License
🎉 项目已完成，可以立即投入使用！
如有问题，请查看 USAGE.md 的故障排查章节。