CI
License: Apache-2.0
Node.js
MCP (Model Context Protocol) server for Hudu IT documentation platform. Provides 39 tools and 6 resources for managing companies, assets, articles, passwords, websites, and more through any MCP-compatible client.
39 MCP tools covering all major Hudu resources6 MCP resources for direct data accessDual transport support: stdio (default) and HTTP StreamableLazy initialization - SDK client created on first tool callConnection testing built-inAll logging to stderr to avoid polluting MCP stdio transport
Deploy to DO
Deploy to Cloudflare Workers
git clone https://github.com/wyre-technology/hudu-mcp.git
cd hudu-mcp
npm install
npm run build
Variable
Required
Default
Description
HUDU_BASE_URLYes
-
Your Hudu instance URL (e.g., https://docs.example.com)
HUDU_API_KEYYes
-
Your Hudu API key
MCP_TRANSPORTNo
stdioTransport type: stdio or http
MCP_HTTP_PORTNo
8080HTTP server port (when using http transport)
MCP_HTTP_HOSTNo
0.0.0.0HTTP server host
MCP_SERVER_NAMENo
hudu-mcpServer name reported to MCP clients
MCP_SERVER_VERSIONNo
1.0.0Server version reported to MCP clients
LOG_LEVELNo
infoLog level: error, warn, info, debug
LOG_FORMATNo
simpleLog format: json or simple
Add to your claude_desktop_config.json:
{
"mcpServers" : {
"hudu" : {
"command" : " node" "args" : [" /path/to/hudu-mcp/dist/entry.js" "env" : {
"HUDU_BASE_URL" : " https://docs.example.com" "HUDU_API_KEY" : " your-api-key" HUDU_BASE_URL=https://docs.example.com \
HUDU_API_KEY=your-api-key \
MCP_TRANSPORT=http \
MCP_HTTP_PORT=8080 \
npm start
Tool
Description
hudu_list_companiesList companies with optional filters
hudu_get_companyGet a company by ID
hudu_create_companyCreate a new company
hudu_update_companyUpdate an existing company
hudu_delete_companyDelete a company
hudu_archive_companyArchive a company
hudu_unarchive_companyUnarchive a company
hudu_test_connectionTest the connection to Hudu API
Tool
Description
hudu_list_assetsList assets with optional filters
hudu_get_assetGet an asset by ID
hudu_create_assetCreate a new asset
hudu_update_assetUpdate an existing asset
hudu_delete_assetDelete an asset
hudu_archive_assetArchive an asset
Tool
Description
hudu_list_asset_layoutsList asset layouts
hudu_get_asset_layoutGet an asset layout by ID
hudu_create_asset_layoutCreate a new asset layout
hudu_update_asset_layoutUpdate an existing asset layout
Asset Passwords (5 tools)
Tool
Description
hudu_list_asset_passwordsList asset passwords
hudu_get_asset_passwordGet an asset password by ID
hudu_create_asset_passwordCreate a new asset password
hudu_update_asset_passwordUpdate an existing asset password
hudu_delete_asset_passwordDelete an asset password
Tool
Description
hudu_list_articlesList knowledge base articles
hudu_get_articleGet an article by ID
hudu_create_articleCreate a new article
hudu_update_articleUpdate an existing article
hudu_delete_articleDelete an article
hudu_archive_articleArchive an article
Tool
Description
hudu_list_websitesList monitored websites
hudu_get_websiteGet a website by ID
hudu_create_websiteCreate a new website
hudu_update_websiteUpdate an existing website
hudu_delete_websiteDelete a website
Other Resources (5 tools)
Tool
Description
hudu_list_foldersList folders
hudu_list_proceduresList procedures
hudu_list_activity_logsList activity logs
hudu_list_relationsList relations
hudu_list_magic_dashList Magic Dash items
URI
Description
hudu://companiesList of all companies
hudu://companies/{id}Company details by ID
hudu://assetsList of all assets
hudu://assets/{id}Asset details by ID
hudu://articlesList of all articles
hudu://articles/{id}Article details by ID
# Install dependencies# Build# Run in development mode# Clean build outputApache-2.0