Skip to main content
Glama

hudu-mcp

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.

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.

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

  2. 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 DO

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

A
license - permissive license
-
quality - not tested
A
maintenance

Maintenance

Maintainers
Response time
1wRelease cycle
18Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    A
    quality
    -
    maintenance
    An MCP server that enables LLMs to interact with IT Glue documentation, including organizations, configurations, passwords, and flexible assets. It provides tools for listing, creating, and updating managed service provider (MSP) data through the IT Glue API.
    Last updated
    31
  • F
    license
    -
    quality
    D
    maintenance
    An MCP server providing 63 tools to interact with Redmine instances, covering issues, projects, time entries, and wiki pages. It utilizes streamable HTTP transport and supports per-client authentication for secure management of Redmine resources.
    Last updated
    35
  • F
    license
    B
    quality
    A
    maintenance
    An MCP server for CIPP (Community IT Professionals Platform), enabling MSPs to manage Microsoft 365 tenants, users, policies, and security settings through CIPP's API.
    Last updated
    43
    8

View all related MCP servers

Related MCP Connectors

  • Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.

  • MCP server for AgentDocs (agentdocs.eu): read, search, write, comment on & share Markdown docs.

  • The MCP server for Azure DevOps, bringing the power of Azure DevOps directly to your agents.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/wyre-technology/hudu-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server