Hudu MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

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

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add -e "HUDU_BASE_URL=${HUDU_BASE_URL}" -e "HUDU_API_KEY=${HUDU_API_KEY}" hudu-mcp -- node "<FULL_PATH_TO_HUDU_MCP>/dist/index.js"

Replace <FULL_PATH_TO_HUDU_MCP>/dist/index.js with the actual folder you prepared in step 1.

Required:HUDU_BASE_URLHUDU_API_KEY+ 2 optional
README.md

MCP server for the Hudu IT documentation platform

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
`hud

Tools (8)

hudu_list_companiesList companies with optional filters
hudu_get_companyGet a company by ID
hudu_list_assetsList assets with optional filters
hudu_get_assetGet an asset by ID
hudu_list_articlesList knowledge base articles
hudu_get_articleGet an article by ID
hudu_list_asset_passwordsList asset passwords
hudu_test_connectionTest the connection to Hudu API

Environment Variables

HUDU_BASE_URLrequiredYour Hudu instance URL
HUDU_API_KEYrequiredYour Hudu API key
MCP_TRANSPORTTransport type: stdio or http
MCP_HTTP_PORTHTTP server port

Configuration

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

Try it

→List all companies currently stored in Hudu.
→Find the asset details for the server with ID 12345.
→Search for knowledge base articles related to network configuration.
→Retrieve the password for the primary domain controller asset.

Frequently Asked Questions

What are the key features of Hudu?

39 MCP tools covering all major Hudu resources. 6 MCP resources for direct data access. Dual transport support: stdio and HTTP. Built-in connection testing. Lazy initialization of SDK client.

What can I use Hudu for?

Quickly retrieving IT documentation while troubleshooting issues in Claude.. Automating the creation of asset records from technical reports.. Searching through internal knowledge base articles to answer user queries.. Managing asset passwords securely through an AI-assisted interface..

How do I install Hudu?

Install Hudu by running: git clone https://github.com/wyre-technology/hudu-mcp.git && cd hudu-mcp && npm install && npm run build

What MCP clients work with Hudu?

Hudu works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Hudu docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare
View all other servers →

Related MCP Servers

Nuclear
Free, open-source music player without ads or tracking.
other17.1K stars
Domain Check
Fast domain availability checker with RDAP/WHOIS lookup and batch checking.
other253 stars
Ableton MCP Extended
Control Ableton Live using natural language via AI assistants
other142 stars
US Government Open Data MCP
MCP Server + TypeScript SDK for 40+ U.S. Government APIs
other90 stars
Garmin Connect
Access your fitness, health, and training data from MCP clients.
other71 stars
BinjaLattice MCP
Secure communication protocol for Binary Ninja and MCP servers
other61 stars