hudu-mcp

hudu-mcp

An MCP server for the Hudu IT documentation platform that provides 39 tools and 6 resources for managing companies, assets, articles, and passwords. It enables users to interact with their documentation and assets through any MCP-compatible client using stdio or HTTP transport.

Category
Visit Server

README

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

One-Click Deployment

Deploy to DO

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

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured