Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@hudu-mcplist 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
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
Installation
git clone https://github.com/wyre-technology/hudu-mcp.git
cd hudu-mcp
npm install
npm run buildConfiguration
Variable | Required | Default | Description |
| Yes | - | Your Hudu instance URL (e.g., |
| Yes | - | Your Hudu API key |
| No |
| Transport type: |
| No |
| HTTP server port (when using |
| No |
| HTTP server host |
| No |
| Server name reported to MCP clients |
| No |
| Server version reported to MCP clients |
| No |
| Log level: |
| No |
| Log format: |
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 startTools (39)
Companies (8 tools)
Tool | Description |
| List companies with optional filters |
| Get a company by ID |
| Create a new company |
| Update an existing company |
| Delete a company |
| Archive a company |
| Unarchive a company |
| Test the connection to Hudu API |
Assets (6 tools)
Tool | Description |
| List assets with optional filters |
| Get an asset by ID |
| Create a new asset |
| Update an existing asset |
| Delete an asset |
| Archive an asset |
Asset Layouts (4 tools)
Tool | Description |
| List asset layouts |
| Get an asset layout by ID |
| Create a new asset layout |
| Update an existing asset layout |
Asset Passwords (5 tools)
Tool | Description |
| List asset passwords |
| Get an asset password by ID |
| Create a new asset password |
| Update an existing asset password |
| Delete an asset password |
Articles (6 tools)
Tool | Description |
| List knowledge base articles |
| Get an article by ID |
| Create a new article |
| Update an existing article |
| Delete an article |
| Archive an article |
Websites (5 tools)
Tool | Description |
| List monitored websites |
| Get a website by ID |
| Create a new website |
| Update an existing website |
| Delete a website |
Other Resources (5 tools)
Tool | Description |
| List folders |
| List procedures |
| List activity logs |
| List relations |
| List Magic Dash items |
Resources
URI | Description |
| List of all companies |
| Company details by ID |
| List of all assets |
| Asset details by ID |
| List of all articles |
| 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