Ufo MCP Server

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 dxt

2.启动HTTP服务器

docker run -d --name ufo-mcp-shared -p 8080:8080 -v "$(pwd)/data:/data" ufo-mcp:local --transport http --port 8080

3.安装扩展

1. 打开克劳德桌面
2. 首选 设置>扩展
3. 拖拽 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支持。

1. 以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

1. 在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)

🐛 故障排除

1. 找不到不明飞行物：在路由器的管理面板中检查不明飞行物的IP地址
2. 连接被拒绝：确保UFO已通电并连接到您的网络
3. 效果不保存：检查效果文件位置的写入权限
4. Docker权限问题：确保效果目录可写

📄 许可证

MIT许可证-有关详细信息，请参阅许可证文件