housekeeper-bee-mcp-server

Thomas-Leung-852/housekeeper-bee-mcp-server

3.2

If you are the rightful owner of housekeeper-bee-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Housekeeper Bee MCP Server is a Model Context Protocol server designed to manage and facilitate communication between different components in a system, ensuring efficient data handling and processing.

housekeeper-bee-mcp-server

Housekeeper Bee MCP Server (STDIO)

Introduction

The MCP Server extends the functionality of the web-based Housekeeper Bee Application, which is designed for structural and fixed information flows. Using LLM, users are allowed to manage their storage box records in a dynamic and unstructured manner. The LLM client enhanced the UI/UX and user satisfaction. In the "Demonstration Clips" section, we show you how to use different languages and simple syntax to manage the storage asset records.


Requirement


System Architecture

[1] "Local Remote" - Housekeeper Bee server app and admin server
[2] Image Source - https://hackteam.io
[3] All system components are in the same Wi-Fi network


Installation

npm install -y

Configuration

Open Claude Desktop confirguration file (claude_desktop_config.json) and add the following lines to the mcpServers section

The claude_desktop_config.json file for Claude Desktop is located in different paths depending on your operating system. For Windows, it's found in %APPDATA%\Claude\claude_desktop_config.json, and for macOS, it's in ~/Library/Application Support/Claude/claude_desktop_config.json.

To find the file:

  1. Windows: Open File Explorer and paste %APPDATA%\Claude\ into the address bar. You will find the claude_desktop_config.json file there.
  2. The file is automatically created when you click "Edit Config" in the Claude Desktop settings, under the "Developer" section. or you can create it manully.

{
	"mcpServers": {
		"housekeeper bee mcp server": {
			"type": "stdio",
			"command": "%ProgramFiles%\\nodejs\\node.exe",
			"args": [
				" {YOUR\\PATH}\\housekeeperbee-mcp-server\\src\\index.js"
			],
			"env" :{
				"HOUSEKEEPER_BEE_USER_API_KEY":"{YOUR HOUSEKEEPER BEE API KEY}",				
        	    "HOUSEKEEPER_BEE_URL":"{HOUSEKEEPER BEE APP SERVER IP}",
        		"HOUSEKEEPER_BEE_PORT":"{HOUSEKEEPER BEE APP SERVER PORT default 8080}",
				"HOUSEKEEPER_BEE_OUTPUT_FILE_PATH": "{local file folder - e.g. c:\\tmp\\ }",
				"HOUSEKEEPER_BEE_ADMIN_URL": "{HOUSEKEEPER BEE ADMIN SERVER IP default same as server ip}",
				"HOUSEKEEPER_BEE_ADMIN_PORT": "{HOUSEKEEPER BEE ADMIN SERVER PORT default 8088}",
			}
		}
	}
}

Sample


  1. Restart the Claude Desktop

Demonstation Clips

YouTube



vNetic workshop - 2025
Last Update: 2025/08/02 by Thomas Leung