# Coreflux MCP Server
## 基本信息
- Slug: `corefluxcommunity-corefluxmcpserver`
- Source: modelscope
- Publisher: @CorefluxCommunity/CorefluxMCPServer
- Categories: home-automation-and-iot / os-automation / cloud-platforms
- Hosted: No
- License: Apache License 2.0
- Source URL: https://www.modelscope.cn/mcp/servers/@CorefluxCommunity/CorefluxMCPServer
## 简介
将克劳德和其他与MCP兼容的AI助手连接到Coreflux MQTT代理，使它们能够通过自然语言发现和执行Coreflux命令，以管理模型、操作、规则和路由。
## 安装提示

```bash
python setup_assistant.py ``` 设置助手帮助您： - 创建或更新包含您的配置的`.env`文件 - 配置MQTT代理设置（主机、端口、凭证） - 如有需要，设置TLS配置 - 配置日志选项 完成配置后，您可以正常运行服务器。 ## 将Claude连接到MCP服务器 ### 使用Claude桌面配置 1. 创建或编辑`~/Library/Application Support/Claude/claude_desktop_config.json`（macOS/Linux）或`%USERPROFILE%\AppData\Roaming\Claude\claude_desktop_config.json`（Windows） 2. 添加以下配置（根据需要调整路径）：
```

## MCP Server 详情

# Coreflux MQTT MCP 服务器

这是一个模型上下文协议（MCP）服务器，它连接到Coreflux MQTT代理，并将Coreflux和MQTT操作作为工具提供给Claude和其他兼容MCP的AI助手。

## 功能

- 连接到Coreflux MQTT代理
- 提供所有Coreflux命令（模型、动作、规则、路由）的工具
- 发现并列出可用的动作
- 包含LOT语言文档作为资源
- 使用官方MCP SDK构建，以实现与Claude的无缝集成
- 独立设置助手用于配置

## 设置助手

该服务器包括一个独立的设置助手，可以与主服务器分开运行。在以下情况下运行设置助手：

- 您需要创建初始配置（.env文件）
- 您想要更新现有配置
- 您遇到连接问题并需要重新配置

要运行设置助手：

```bash
python setup_assistant.py
```


设置助手帮助您：

- 创建或更新包含您的配置的`.env`文件
- 配置MQTT代理设置（主机、端口、凭证）
- 如有需要，设置TLS配置
- 配置日志选项

完成配置后，您可以正常运行服务器。

## 将Claude连接到MCP服务器

### 使用Claude桌面配置

1. 创建或编辑`~/Library/Application Support/Claude/claude_desktop_config.json`（macOS/Linux）或`%USERPROFILE%\AppData\Roaming\Claude\claude_desktop_config.json`（Windows）
2. 添加以下配置（根据需要调整路径）：
   ```json
   {
     "mcpServers": {
       "coreflux": {
         "command": "python",
         "args": [
           "/PATH/TO/server.py",
           "--mqtt-host", "localhost", 
           "--mqtt-port", "1883",
           "--mqtt-user", "root",
           "--mqtt-password", "coreflux",
           "--mqtt-client-id", "claude-coreflux-client"
         ],
         "description": "Coreflux MQTT Broker Control",
         "icon": "🔄",
         "env": {}
       }
     }
   }
   ```
3. 重启Claude桌面应用

### 命令行参数

服务器接受以下命令行参数。这些设置也可以通过使用设置助手的`.env`文件进行配置：

| 参数 | 描述 | 默认值 |
|----------|-------------|---------|
| `--mqtt-host` | MQTT代理地址 | localhost |
| `--mqtt-port` | MQTT代理端口 | 1883 |
| `--mqtt-user` | MQTT用户名 | - |
| `--mqtt-password` | MQTT密码 | - |
| `--mqtt-client-id` | MQTT客户端ID | claude-mcp-client |
| `--mqtt-use-tls` | 启用MQTT连接的TLS | false |
| `--mqtt-ca-cert` | CA证书文件路径 | - |
| `--mqtt-client-cert` | 客户端证书文件路径 | - |
| `--mqtt-client-key` | 客户端密钥文件路径 | - |
| `--log-level` | 日志级别 (DEBUG/INFO/WARNING/ERROR/CRITICAL) | INFO |

## 可用工具

服务器提供了常见的Coreflux命令工具：

- `add_rule`: 添加新的权限规则
- `remove_rule`: 移除权限规则
- `add_route`: 添加新的路由连接
- `remove_route`: 移除路由连接
- `add_model`: 添加新的模型结构
- `remove_model`: 移除模型结构
- `add_action`: 添加新的动作事件/函数
- `remove_action`: 移除动作事件/函数
- `run_action`: 运行动作事件/函数
- `remove_all_models`: 移除所有模型
- `remove_all_actions`: 移除所有动作
- `remove_all_routes`: 移除所有路由
- `list_discovered_actions`: 列出所有发现的Coreflux动作
- `request_lot_code`: 根据自然语言提示生成LOT代码

## 调试和故障排除

如果您遇到问题：

1. 在Claude配置中验证您的MQTT代理凭据
2. 确保代理可访问
3. 运行设置助手以验证或更新您的配置：
   ```bash
   python setup_assistant.py
   ```
4. 检查Claude桌面日志：
   ```bash
   # 检查Claude的日志错误（macOS/Linux）
   tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
   # Windows PowerShell
   Get-Content -Path "$env:USERPROFILE\AppData\Roaming\Claude\Logs\mcp*.log" -Tail 20 -Wait
   ```
5. 使用调试日志运行服务器：
   ```bash
   # 直接执行并启用调试日志
   python server.py --mqtt-host localhost --mqtt-port 1883 --log-level DEBUG
   ```

## 参考资料

- [MCP 服务器开发者的快速入门指南](https://modelcontextprotocol.io/quickstart/server)
- [MCP 官方文档](https://modelcontextprotocol.io/)