How do I use hudu-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@hudu-mcp list all assets for the company 'Acme Corp'" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

hudu-mcp

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.

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

Related MCP server: redmine-mcp

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).

Deploy to Cloudflare Workers

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 awrangler.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:

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:

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

hudu-mcp

hudu-mcp

Features

One-Click Deployment

Installation

Configuration

Usage

Claude Desktop (stdio)

HTTP Transport

Tools (39)

Companies (8 tools)

Assets (6 tools)

Asset Layouts (4 tools)

Asset Passwords (5 tools)

Articles (6 tools)

Websites (5 tools)

Other Resources (5 tools)

Resources

Development

License

Maintenance

Resources

Latest Blog Posts

MCP directory API