Flair MCP

Flair MCP

*人工智能工具和Flair之间礼貌的偏执桥梁。*

用于Flair的实用MCP服务器，具有OAuth2客户端凭据身份验证、安全默认值和处理操作员管道的设置自动化。

本项目不隶属于Flair，也不由Flair认可或维护。\ 对于API正式入职：https://api.flair.co/

从这里开始（60秒）

mkdir -p /home/$USER/apps && ( [ -d /home/$USER/apps/flair-mcp/.git ] && git -C /home/$USER/apps/flair-mcp pull --ff-only origin main || git clone https://github.com/masltov-creations/flair-mcp /home/$USER/apps/flair-mcp ) && cd /home/$USER/apps/flair-mcp && ./scripts/setup.sh

这里没有浏览器OAuth步骤。此服务器使用 client_credentials.

什么设置为您处理

./scripts/setup.sh 是主要工作流，可以安全地重新运行。

它可以：

• 写入/更新 .env 默认值
• 收集Flair API证书
• 配置读/写权限模式
• 安装依赖项并构建
• 可选择安装/刷新systemd服务
• 可选择安装 SKILL.md 对于OpenClaw
• 可选配置和验证 mcporter
• 可选择在SmartThings网关设置中将Flair注册为上游
• 等待健康准备和深度健康验证

设置要求您做什么

• FLAIR_CLIENT_ID
• FLAIR_CLIENT_SECRET
• 许可模式(read 或 write)
• 可选的systemd安装
• 可选的OpenClaw技能安装
• 可选的 mcporter 注册/验证
• 可选的SmartThings网关集成

提供商访问检查表

1. 开始于https://api.flair.co/
2. 按照官方入门步骤获取：

• FLAIR_CLIENT_ID
• FLAIR_CLIENT_SECRET

1. 跑 ./scripts/setup.sh 并提供凭证。
2. 验证 /healthz?deep=1.

快速验证

curl -sS http://127.0.0.1:8090/healthz?deep=1
npx -y mcporter list flair --schema

如果 ok: true 和 deep.ok: true，服务器已准备就绪。

技能（法学硕士）

使用 SKILL.md 作为操作员指南：

• 刀具路径
• 渐进式披露
• 输出格式化合同
• 编写安全确认流程

安装程序可以在检测到OpenClaw时自动安装此程序。

工具亮点

读取/查询

• health_check
• list_resource_types
• list_structures
• list_rooms
• list_vents
• list_devices
• list_named_devices
• list_room_temperatures
• list_device_room_temperatures
• list_vents_with_room_temperatures
• list_vents_by_room_temperature
• list_open_vents_in_cold_rooms （便捷快捷方式）
• list_resources
• get_resource
• get_related_resources

写入/控制（默认禁用）

• update_resource_attributes
• create_resource
• set_vent_percent_open
• set_vent_percent_open_and_verify （首选：写入+状态验证）

通过设置启用写入(FLAIR_PERMISSION_MODE=write)或 WRITE_TOOLS_ENABLED=true.

快速查询示例

# Generic vent filter: open vents in rooms below 68F
npx -y mcporter call --server flair --tool list_vents_by_room_temperature --args '{"temperature_operator":"lt","threshold_temp_f":68,"vent_state":"open"}' --output json

# Generic vent filter: closed vents in rooms above 74F
npx -y mcporter call --server flair --tool list_vents_by_room_temperature --args '{"temperature_operator":"gt","threshold_temp_f":74,"vent_state":"closed"}' --output json

# Convenience shortcut
npx -y mcporter call --server flair --tool list_open_vents_in_cold_rooms --args '{"below_temp_f":68,"min_percent_open":1}' --output json

# Preferred write path: set vent and verify observed state in one call
npx -y mcporter call --server flair --tool set_vent_percent_open_and_verify --args '{"vent_id":"","percent_open":30}' --output json

set_vent_percent_open_and_verify 仅在启用写入模式时可用。

OpenClaw+mcporter

注册服务器：

npx -y mcporter config add flair http://localhost:8090/mcp --allow-http --transport http --scope home

列出工具：

npx -y mcporter list flair --schema

可选集成

如果您单独运行SmartThings MCP网关，安装程序可以在那里添加Flair作为命名上游。

该集成是可选的，仅在您选择时启用。

常见操作

更新运行时安装并重新启动：

cd /home/$USER/apps/flair-mcp && git pull --ff-only origin main && npm run build && sudo systemctl restart flair-mcp

切换到写入模式：

cd /home/$USER/apps/flair-mcp && FLAIR_PERMISSION_MODE=write INSTALL_SYSTEMD=false INSTALL_OPENCLAW_SKILL=false CONFIGURE_MCPORTER=false INTEGRATE_SMARTTHINGS_GATEWAY=false ./scripts/setup.sh && sudo systemctl restart flair-mcp

切换回只读模式：

cd /home/$USER/apps/flair-mcp && FLAIR_PERMISSION_MODE=read INSTALL_SYSTEMD=false INSTALL_OPENCLAW_SKILL=false CONFIGURE_MCPORTER=false INTEGRATE_SMARTTHINGS_GATEWAY=false ./scripts/setup.sh && sudo systemctl restart flair-mcp

安全地重新运行安装程序：

cd /home/$USER/apps/flair-mcp && ./scripts/setup.sh

手动安装工作区技能：

install -Dm644 SKILL.md ~/.openclaw/workspace/skills/flair-mcp/SKILL.md

故障排除（快速点击）

• deep.ok: false 和 invalid_client

凭据错误。使用重新运行安装程序 FORCE_REENTER_CREDS=true.

• 服务启动，但工具看起来很旧

提取最新版本、重建、重新启动服务、重新列出工具。

• Host not allowed

更新 ALLOWED_MCP_HOSTS 并重新启动。

• 名称看起来很通用

使用 list_named_devices 而不是 list_devices.

• 查询速度慢

使用聚合工具(list_device_room_temperatures, list_vents_by_room_temperature)与 room_id, structure_id, max_items.

安全说明

• 保守秘密 .env从不使用git。
• 令牌永远不会被工具返回。
• 执行主机/来源检查。
• 代理层在写入操作之前应要求明确确认。

建筑（高级）

MCP client -> Flair MCP -> Flair API (api.flair.co)
                    |
          OAuth2 client_credentials token flow

许可证

麻省理工学院