io.github.wyre-technology/hudu-mcp

Official

by wyre-technology · TypeScript

Hudu

MCP server for Hudu IT documentation — companies, assets, articles, passwords, and procedures.

IT documentation platform for managing companies, assets, articles, passwords, and procedures.

Topics

hudumcpmodel-context-protocolmsptypescriptwyre-technologymsp-mcp

README.md8 KBView on GitHub

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

IMPORTANT

Before you click: this server depends on @wyre-technology/node-hudu, which is hosted on the GitHub Packages npm registry. GitHub Packages has no anonymous access — even though the package is public, every npm install needs a token. The cloud builder runs npm install for you, so you must give it one, or the build fails with npm error 401 Unauthorized ... npm.pkg.github.com.

Create a GitHub Personal Access Token with the read:packages scope (classic token). Any GitHub account works — you do not need to be a member of the wyre-technology org to read its public packages.
Add it as a build variable when prompted by the deploy flow:
- DigitalOcean App Platform → set an encrypted env var named NODE_AUTH_TOKEN with scope Build Time to your PAT (the Dockerfile reads it via ARG NODE_AUTH_TOKEN to authenticate npm ci).
- Cloudflare Workers → set a build variable named NODE_AUTH_TOKEN to your PAT (Workers → Settings → Build → Variables and Secrets).

NOTE

The DigitalOcean target builds the full Docker image and runs the complete MCP server over HTTP — this is the recommended path for operators. This repo does not ship a wrangler.json/Workers entrypoint, so for a self-hosted server prefer DigitalOcean or the prebuilt container image (ghcr.io/wyre-technology/hudu-mcp).

Installation

This project depends on @wyre-technology/node-hudu, published to the GitHub Packages npm registry, which requires a token even for public packages. Authenticate npm once before installing:

bash

git clone https://github.com/wyre-technology/hudu-mcp.git
cd hudu-mcp

# Authenticate npm to GitHub Packages (token needs the read:packages scope)
export NODE_AUTH_TOKEN=$(gh auth token)   # or a PAT with read:packages

npm install
npm run build

The repo's .npmrc already points the @wyre-technology scope at GitHub Packages and reads the token from NODE_AUTH_TOKEN, so no further config is needed.

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:

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

bash

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

bash

# 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

Install

Configuration

Environment variables

HUDU_API_KEYrequiredsecret

Hudu API key from your Hudu instance admin settings

HUDU_BASE_URLrequired

Hudu instance base URL (e.g. https://yourcompany.huducloud.com)

MCP_TRANSPORTdefault stdio

Transport mode for the server. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting.

AUTH_MODEdefault env

Credential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway.

LOG_LEVELdefault info

Log verbosity: debug, info, warn, error

claude_desktop_config.json

{
  "mcpServers": {
    "hudu-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wyre-technology/hudu-mcp:v1.3.1"
      ],
      "env": {
        "HUDU_API_KEY": "<YOUR_HUDU_API_KEY>",
        "HUDU_BASE_URL": "<YOUR_HUDU_BASE_URL>",
        "MCP_TRANSPORT": "stdio",
        "AUTH_MODE": "env",
        "LOG_LEVEL": "info"
      }
    }
  }
}