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

One-Click Deployment

Deploy to Cloudflare Workers

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

This server cannot be installed

A

license - permissive license

-

quality - not tested

B

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

5dRelease cycle

14Releases (12mo)

Resources

GitHub Repository

Need Help?

Related Servers

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