wyre-ai/hudu-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

3 stars 5 forks 质量 81 趋势 30Apache-2.0

Repository Install

MCP (Model Context Protocol) server for Hudu IT documentation platform

概览

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. - covering all major Hudu resources - for direct data access - : classic HUDU_API_KEY REST access, or oauth — a thin, authenticated proxy to a newer Hudu instance's own native MCP server - support: stdio (default) and HTTP Streamable - - SDK client created on first tool call - built-in - to avoid polluting MCP stdio transport this server depends on @wyre-technology/node-hudu, which is hosted on the npm registry. GitHub Packages has no anonymous access — even though the package is public, every npm install needs a token. The cloud builder runs npm install for you, so you must give it one, or the build fails with npm error 401 Unauthorized ... npm.pkg.github.com. 1. Create a GitHub with the read:packages scope (classic token).

README

以下为原文 README 节选，完整内容请查看原文。

hudu-mcp

Features

39 MCP tools covering all major Hudu resources
6 MCP resources for direct data access
Dual auth mode: classic HUDU_API_KEY REST access, or oauth — a thin, authenticated proxy to a newer Hudu instance’s own native MCP server
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 no anonymous access — even though the package is public, every npm install needs a token. The cloud builder runs npm install for you, so you must give it one, or the build fails with npm error 401 Unauthorized ... npm.pkg.github.com.

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 the wyre-technology org to read its public packages.

Add it as a build variable when prompted by the deploy flow:

DigitalOcean App Platform → set an encrypted env var named NODE_AUTH_TOKEN with scope Build Time to your PAT (the Dockerfile reads it via ARG 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 MCP server over HTTP — this is the recommended path for operators. This repo does not ship a wrangler.json/Workers entrypoint, so for a self-hosted server prefer DigitalOcean or the prebuilt container image (ghcr.io/wyre-ai/hudu-mcp).

Installation

在 GitHub 查看完整 README

安装

docker run \

新手？先看 mcpskill.org 教程 →

配置

{
  "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"
      }
    }
  }
}