UFO MCP服务器
通过兼容MCP的客户端（如Claude Desktop）控制您的Dynatrace UFO设备。
版本1.0.1 -MCP规范2024-11-05
🚀 快速开始
先决条件
- 您网络上的Dynatrace UFO设备
- 找到你的不明飞行物的IP地址（检查你的路由器或使用
ufo.local如果mDNS可用）
📦 安装
选项1：直接下载（推荐）
# macOS (Apple Silicon)
curl -L https://github.com/starspace46/ufo/releases/download/v1.0.1/ufo-mcp-darwin-arm64 -o /usr/local/bin/ufo-mcp
chmod +x /usr/local/bin/ufo-mcp
# macOS (Intel)
curl -L https://github.com/starspace46/ufo/releases/download/v1.0.1/ufo-mcp-darwin-amd64 -o /usr/local/bin/ufo-mcp
chmod +x /usr/local/bin/ufo-mcp
# Linux
curl -L https://github.com/starspace46/ufo/releases/download/v1.0.1/ufo-mcp-linux-amd64 -o /usr/local/bin/ufo-mcp
chmod +x /usr/local/bin/ufo-mcp选项2:Docker
docker pull starspace46/ufo-mcp:latest
# Run with Docker
docker run -d \
--name ufo-mcp \
-e UFO_IP=YOUR_UFO_IP_HERE \
-v ~/.ufo-effects:/data \
starspace46/ufo-mcp:latest选项3：从源代码构建
git clone https://github.com/starspace46/ufo-mcp-server.git
cd ufo-mcp-server
go build -o ufo-mcp ./cmd/server
sudo mv ufo-mcp /usr/local/bin/🔧 客户端设置
选项A：桌面扩展（建议用于多代理）
对于 多智能体协调 如果多个Claude Desktop实例共享相同的UFO状态，请使用桌面扩展：
1.构建扩展
make dxt2.启动HTTP服务器
docker run -d --name ufo-mcp-shared -p 8080:8080 -v "$(pwd)/data:/data" ufo-mcp:local --transport http --port 80803.安装扩展
- 打开克劳德桌面
- 首选 设置>扩展
- 拖拽
build/ufo-mcp.dxt进入扩展区
优点：
- ✅ 多个Claude Desktop实例共享UFO状态
- ✅ 代理之间的实时协调
- ✅ 集中效果叠加管理
- ✅ 无需编辑配置文件
看 扩展名/README.md 详细文档。
选项B：直接MCP配置
对于 单药 使用或当您更喜欢传统的MCP服务器配置时：
克劳德桌面
添加到您的Claude Desktop配置中：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json\ 视窗: %APPDATA%\Claude\claude_desktop_config.json
直接安装
{
"mcpServers": {
"ufo": {
"command": "/usr/local/bin/ufo-mcp",
"args": [
"--transport", "stdio",
"--ufo-ip", "YOUR_UFO_IP_HERE"
]
}
}
}Docker安装
{
"mcpServers": {
"ufo": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "UFO_IP=YOUR_UFO_IP_HERE",
"-v", "~/.ufo-effects:/data",
"starspace46/ufo-mcp:latest",
"--transport", "stdio"
]
}
}
}Cline（VS代码扩展）
添加到VS代码设置.json：
直接安装
{
"mcp.servers": {
"ufo": {
"command": "/usr/local/bin/ufo-mcp",
"args": ["--transport", "stdio", "--ufo-ip", "YOUR_UFO_IP_HERE"]
}
}
}Docker安装
{
"mcp.servers": {
"ufo": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "UFO_IP=YOUR_UFO_IP_HERE",
"-v", "~/.ufo-effects:/data",
"starspace46/ufo-mcp:latest",
"--transport", "stdio"
]
}
}
}MuleSoft任意点代码生成器
UFO MCP服务器包括对MuleSoft MCP连接器（0.1.0-BETA）的传统SSE支持。
- 以HTTP模式启动服务器：
# Direct
ufo-mcp --transport http --port 8080 --ufo-ip YOUR_UFO_IP_HERE --effects-file ./data/effects.json
# Docker
docker run -d \
--name ufo-mcp-http \
-p 8080:8080 \
-e UFO_IP=YOUR_UFO_IP_HERE \
-v ~/.ufo-effects:/data \
starspace46/ufo-mcp:latest \
--transport http- 在Anypoint代码生成器中，配置MCP连接：
- 服务器URL: http://localhost:8080 - SSE端点路径： /sse - 服务器将自动处理重新连接时的会话持久性
其他MCP客户端
对于标准HTTP/2 MCP客户端，请连接到 http://localhost:8080/mcp
服务器同时支持多种传输模式：
- 标准：桌面客户端的标准I/O（Claude、Cline）
- 超文本传输协议：用于基于web的客户端的HTTP/2+SSE
- 传统SSE：用于MuleSoft兼容性的双向SSE
💡 使用示例
配置后，让Claude：
- “把不明飞行物变成红色” -将所有LED设置为红色
- “播放彩虹效果” -启动彩色动画
- “将顶环设置为蓝色，底环设置为绿色” -独立环控
- “将亮度设置为50%” -调整整体亮度
- “为顶环添加旋转” -制作环形图案动画
- “显示当前不明飞行物状态” -查看当前显示的内容
🎨 内置效果
服务器包括预配置的效果：
- 彩虹 -旋转彩虹色（永久）
- 呼吸绿色 -平静的绿色脉搏（永久）
- policeLights -应急灯模式（30秒）
- 海浪 -舒缓的蓝色波浪（永恒）
- 火光 -闪烁的火焰效果（永久）
- alertPulse -红色警报闪烁（20秒）
🛠️ 可用工具
configureLighting-在一个命令中设置整个不明飞行物照明（顶环、底环、徽标）sendRawApi-直接向UFO发送原始API命令playEffect-从库中播放命名的灯光效果stopEffect-停止当前效果并从堆栈中恢复上一个效果getLedState-查询当前LED状态listEffects-显示所有可用效果（内置和自定义）
📝 配置选项
命令行参数
--transport或-t：运输类型(stdio或http，默认值：stdio)--port：使用HTTP传输时的HTTP端口（默认值：8080)--ufo-ip：UFO设备IP地址（覆盖UFO_IP任何人）--effects-file：JSON文件的效果路径（默认值：/data/effects.json)
环境变量
UFO_IP：UFO设备IP地址或主机名（例如。，192.168.1.100或ufo.local)
🐛 故障排除
- 找不到不明飞行物：在路由器的管理面板中检查不明飞行物的IP地址
- 连接被拒绝：确保UFO已通电并连接到您的网络
- 效果不保存：检查效果文件位置的写入权限
- Docker权限问题：确保效果目录可写
📄 许可证
MIT许可证-有关详细信息，请参阅许可证文件