hudu-mcp

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 noanonymous access — even though the package is public, every npm install needs atoken. The cloud builder runs npm install for you, so you must give it one, orthe 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 thewyre-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_TOKENwith scope Build Time to your PAT (the Dockerfile reads it viaARG 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 MCPserver over HTTP — this is the recommended path for operators. This repo does notship a wrangler.json/Workers entrypoint, so for a self-hosted server preferDigitalOcean or the prebuilt container image (ghcr.io/wyre-ai/hudu-mcp).

Installation

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

git clone https://github.com/WYRE-AI/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 andreads the token from NODE_AUTH_TOKEN, so no further config is needed.

Configuration

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)

Assets (6 tools)

Asset Layouts (4 tools)

Asset Passwords (5 tools)

Articles (6 tools)

Websites (5 tools)

Other Resources (5 tools)

Resources

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