balenamcp (Balena Io Experimental)

BalenaMCP

一个简单的MCP服务器，它封装了 balena CLI提供Balena功能 支持的客户。

先决条件

• 转到1.21或更高版本
• balena CLI已安装并在PATH中可用
• 已安装Claude Desktop

安装

# Clone the repository
git clone https://github.com/klutchell/balenamcp.git
cd balenamcp

# Install dependencies
go mod download

# Build the binary
go build -o bin/balenamcp

配置

Claude桌面设置

1. 打开克劳德桌面

1. 转到克劳德菜单，选择“设置…”

1. 点击左侧栏中的“开发人员”

您可能需要启用开发人员模式才能看到此选项。

1. 点击“编辑配置”

这将在以下位置创建或打开配置文件：

- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json

1. 将以下配置添加到文件中：

   {
     "mcpServers": {
       "balenamcp": {
         "command": "/full/path/to/your/balenamcp/bin/balenamcp",
         "args": []
       }
     }
   }

确保更换 /full/path/to/your/balenamcp 通过绝对路径 您的项目目录。

1. 保存文件并重新启动Claude Desktop

认证

在使用这些工具之前，请确保您已通过Balena的身份验证：

balena login

可用的MCP命令

通过BalenaMCP可以使用以下命令：

• device-list：列出所有设备
• device-logs：显示设备日志（需要设备UUID或名称）
• fleet-list：列出所有车队
• os-versions：显示设备类型的可用balenaOS版本（需要

设备类型）

• release-list：列出车队的所有版本（需要车队名称）
• release-info：获取发布信息（需要发布ID）
• version：显示balena CLI的版本信息
• tag-list：列出车队、设备或版本的所有标签（需要资源

类型和名称）

每个命令都可以直接通过Claude Desktop访问。

发展

服务器是使用 MCP Go库 并与 Claude Desktop通过标准输入/输出流。

项目结构

• main.go：带有工具定义的主服务器实现
• server/setup.go：服务器设置和工具实现
• main_test.go：服务器实现测试
• bin/：内置二进制文件（gitignored）

建筑

# Build for current platform
go build -o bin/balenamcp

# Build for specific platforms
GOOS=linux GOARCH=amd64 go build -o bin/balenamcp-linux-amd64
GOOS=windows GOARCH=amd64 go build -o bin/balenamcp-windows-amd64.exe
GOOS=darwin GOARCH=amd64 go build -o bin/balenamcp-darwin-amd64
GOOS=darwin GOARCH=arm64 go build -o bin/balenamcp-darwin-arm64

运行测试

go test ./...

故障排除

如果遇到MCP服务器问题：

1. 检查登录：

- macOS： ~/Library/Logs/Claude/mcp-server-balenamcp.log - 窗户： %APPDATA%\Claude\logs\mcp-server-balenamcp.log

1. 确保balenamcp二进制文件的路径正确且绝对

1. 确保您拥有执行二进制文件所需的权限

1. 验证是否已在PATH中安装并可访问balena

许可证

麻省理工学院