homebox mcp
MCP（模型上下文协议）服务器 灵通无绳 房屋库存管理。
提供50多种工具，涵盖整个Homebox API：项目、位置、标记、维护、附件、模板、统计信息、组、通知程序等。
设置
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
HOMEBOX_URL | 是 | 您的Homebox实例URL（例如。， https://homebox.example.com) |
HOMEBOX_USERNAME | 是\* | 主页用户名/电子邮件 |
HOMEBOX_PASSWORD | 是\* | 主页密码 |
HOMEBOX_TOKEN | 否 | 预认证的承载令牌（用户名/密码的替代品） |
\*除非满足以下条件，否则必须 HOMEBOX_TOKEN 提供。
克劳德代码
添加 ~/.claude/settings.json:
{
"mcpServers": {
"homebox": {
"command": "node",
"args": ["/path/to/homebox-mcp/dist/index.js"],
"env": {
"HOMEBOX_URL": "https://homebox.example.com",
"HOMEBOX_USERNAME": "your-email",
"HOMEBOX_PASSWORD": "your-password"
}
}
}
}克劳德桌面
添加 claude_desktop_config.json:
{
"mcpServers": {
"homebox": {
"command": "node",
"args": ["/path/to/homebox-mcp/dist/index.js"],
"env": {
"HOMEBOX_URL": "https://homebox.example.com",
"HOMEBOX_USERNAME": "your-email",
"HOMEBOX_PASSWORD": "your-password"
}
}
}
}构建
npm install
npm run build工具
物品
list_items-具有过滤和分页功能的查询项get_item-获取完整的商品详细信息create_item-创建新项目update_item-完整项目更新（所有字段）patch_item-部分更新（位置、数量、标签）delete_item-删除项目duplicate_item-复制项目get_item_path-获取项目的位置路径get_item_by_asset_id-按资产ID查找get_custom_field_names-列出自定义字段名称get_custom_field_values-列出自定义字段值import_items-从CSV导入export_items-导出到CSV
位置
list_locations-列出所有地点get_location-获取位置详细信息get_location_tree-分层位置树create_location-创建位置update_location-更新位置delete_location-删除位置
标签
list_tags,get_tag,create_tag,update_tag,delete_tag
维护
list_maintenance-列出条目（全部或每个项目）create_maintenance_entry,update_maintenance_entry,delete_maintenance_entry
附件
get_attachment,upload_attachment,update_attachment,delete_attachment
模板
list_templates,get_template,create_template,update_template,delete_template,create_item_from_template
统计
get_statistics-总体库存统计get_statistics_by_location,get_statistics_by_tag,get_purchase_price_statistics
群组
get_group,update_group,list_group_members,add_group_member,remove_group_member,list_group_invitations,create_group_invitation
通知人
list_notifiers,create_notifier,update_notifier,delete_notifier,test_notifier
行动
ensure_asset_ids,ensure_import_refs,create_missing_thumbnails,set_primary_photos,zero_item_time_fields,wipe_inventory
用户
get_user_self,update_user_self,change_password
杂项
get_status,get_currencies,search_barcode,export_bill_of_materials