Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1
Prepare the server locally
Run this once before adding it to Claude Code.
git clone https://github.com/wyre-technology/hudu-mcp.git
cd hudu-mcp
npm install
npm run build2
Register it in Claude Code
claude mcp add -e "HUDU_BASE_URL=${HUDU_BASE_URL}" -e "HUDU_API_KEY=${HUDU_API_KEY}" hudu-mcp -- node /path/to/hudu-mcp/dist/entry.jsReplace any placeholder paths in the command with the real path on your machine.
Required:
HUDU_BASE_URLHUDU_API_KEY+ 2 optional3
Make your agent remember this setup
hudu-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- 39 MCP tools covering all major Hudu resources
- 6 MCP resources for direct data access
- Dual transport support: stdio and HTTP
- Built-in connection testing
- Lazy initialization of SDK client
Tools 8
hudu_list_companiesList companies with optional filtershudu_get_companyGet a company by IDhudu_list_assetsList assets with optional filtershudu_get_assetGet an asset by IDhudu_list_articlesList knowledge base articleshudu_get_articleGet an article by IDhudu_list_asset_passwordsList asset passwordshudu_test_connectionTest the connection to Hudu APIEnvironment Variables
HUDU_BASE_URLrequiredYour Hudu instance URLHUDU_API_KEYrequiredYour Hudu API keyMCP_TRANSPORTTransport type: stdio or httpMCP_HTTP_PORTHTTP server portTry it
→List all companies currently stored in Hudu.
→Find the asset details for the server with ID 12345.
→Search for knowledge base articles related to network configuration.
→Retrieve the password for the primary domain controller asset.
Original README from wyre-technology/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
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 |
| `hud |