hudu-mcp

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.

Features

• 39 MCP tools covering all major Hudu resources
• 6 MCP resources for direct data access
• Dual transport support: stdio (default) and HTTP Streamable
• Lazy initialization - SDK client created on first tool call
• Connection testing built-in
• All logging to stderr to avoid polluting MCP stdio transport

One-Click Deployment

Installation

git clone https://github.com/wyre-technology/hudu-mcp.git
cd hudu-mcp
npm install
npm run build

Configuration

Variable	Required	Default	Description
HUDU_BASE_URL	Yes	-	Your Hudu instance URL (e.g., https://docs.example.com)
HUDU_API_KEY	Yes	-	Your Hudu API key
MCP_TRANSPORT	No	stdio	Transport type: stdio or http
MCP_HTTP_PORT	No	8080	HTTP server port (when using http transport)
MCP_HTTP_HOST	No	0.0.0.0	HTTP server host
MCP_SERVER_NAME	No	hudu-mcp	Server name reported to MCP clients
MCP_SERVER_VERSION	No	1.0.0	Server version reported to MCP clients
LOG_LEVEL	No	info	Log level: error, warn, info, debug
LOG_FORMAT	No	simple	Log format: json or simple

Usage

Claude Desktop (stdio)

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"
      }
    }
  }
}

HTTP Transport

HUDU_BASE_URL=https://docs.example.com \
HUDU_API_KEY=your-api-key \
MCP_TRANSPORT=http \
MCP_HTTP_PORT=8080 \
npm start

Tools (39)

Companies (8 tools)

Tool	Description
hudu_list_companies	List companies with optional filters
hudu_get_company	Get a company by ID
hudu_create_company	Create a new company
hudu_update_company	Update an existing company
hudu_delete_company	Delete a company
hudu_archive_company	Archive a company
hudu_unarchive_company	Unarchive a company
hudu_test_connection	Test the connection to Hudu API

Assets (6 tools)

Tool	Description
hudu_list_assets	List assets with optional filters
hudu_get_asset	Get an asset by ID
hudu_create_asset	Create a new asset
hudu_update_asset	Update an existing asset
hudu_delete_asset	Delete an asset
hudu_archive_asset	Archive an asset

Asset Layouts (4 tools)

Tool	Description
hudu_list_asset_layouts	List asset layouts
hudu_get_asset_layout	Get an asset layout by ID
hudu_create_asset_layout	Create a new asset layout
hudu_update_asset_layout	Update an existing asset layout

Asset Passwords (5 tools)

Tool	Description
hudu_list_asset_passwords	List asset passwords
hudu_get_asset_password	Get an asset password by ID
hudu_create_asset_password	Create a new asset password
hudu_update_asset_password	Update an existing asset password
hudu_delete_asset_password	Delete an asset password

Articles (6 tools)

Tool	Description
hudu_list_articles	List knowledge base articles
hudu_get_article	Get an article by ID
hudu_create_article	Create a new article
hudu_update_article	Update an existing article
hudu_delete_article	Delete an article
hudu_archive_article	Archive an article

Websites (5 tools)

Tool	Description
hudu_list_websites	List monitored websites
hudu_get_website	Get a website by ID
hudu_create_website	Create a new website
hudu_update_website	Update an existing website
hudu_delete_website	Delete a website

Other Resources (5 tools)

Tool	Description
hudu_list_folders	List folders
hudu_list_procedures	List procedures
hudu_list_activity_logs	List activity logs
hudu_list_relations	List relations
hudu_list_magic_dash	List Magic Dash items

Resources

URI	Description
hudu://companies	List of all companies
hudu://companies/{id}	Company details by ID
hudu://assets	List of all assets
hudu://assets/{id}	Asset details by ID
hudu://articles	List of all articles
hudu://articles/{id}	Article details by ID

Development

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

# Clean build output
npm run clean

License

Apache-2.0