Skills MCP Hudu

🚀 技能MCP胡都

完整的Hudu MCP服务器，包含43个工具、Markdown输出、MCP资源和多租户支持

  ](https://nodejs.org/)    

将Claude Code、Gemini CLI、ChatGPT、VS Code Copilot和Cursor连接到您的Hudu实例

特性 • 安装 • 43工具 • 快速开始 • 支持

______________________________________________________________________

📖 关于项目

技能MCP胡都 是一个生产就绪的模型上下文协议（MCP）服务器，提供与 胡图 IT文档平台。建造于 IT技能来自巴西的管理服务提供商（MSP），该MCP使AI助手能够与您的IT文档、密码、资产和程序无缝交互。

🌟 为什么选择MCP？

专为 MSP和IT团队 需要人工智能访问其Hudu文档的人：

______________________________________________________________________

🎯 主要特点

1.📚 完整的IT文档

在人工智能的帮助下管理公司、资产、文章和知识库。

2.🔐 安全密码管理

通过具有适当身份验证的AI安全访问和管理凭据。

3.🔄 程序和工作流程

使用人工智能驱动的自动化创建、更新和管理程序和任务。

4.🌐 网络基础设施

完整的网络文档，包括VLAN、IP地址和机架存储。

5.🔍 全局搜索

通过单一查询对所有Hudu资源进行强大搜索。

6.📊 Markdown格式输出

所有工具响应都返回人类可读的Markdown表，而不是原始JSON，由集中式响应格式化器拦截器提供支持。

7.📅 过期跟踪和网站监控

跟踪域、SSL证书、保修和许可证到期情况。监控网站DNS、SSL和WHOIS状态。

8.📋 活动审核日志

按用户、资源类型、操作和日期范围使用过滤器完成审计跟踪。

9. 🏢 多租户支持

管理多个客户的MSP的公司级过滤。

______________________________________________________________________

💼 需要Hudu或AI方面的帮助吗？ 技能IT-技术解决方案 专门从事IT基础设施，在以下方面拥有深厚的专业知识 沪都IT文档平台我们的团队在以下方面拥有专业知识 人工智能 和 模型上下文协议（MCP），为自动化和系统集成提供完整的解决方案。 我们的服务： - ✅ 沪都咨询与实施 - ✅ 为您的基础设施定制MCP开发 - ✅ 人工智能与企业系统的集成 - ✅ IT文档自动化 - ✅ 专业培训和支持 📞 WhatsApp/电话： +55 63 3224-4925-巴西🇧🇷 🌐 网站： skillsit.com.br 📧 电子邮件： contato@skillsit.com.br *“将基础设施转变为智能”*

______________________________________________________________________

🏗️ 建筑

┌─────────────────────────────────────────────────────────────────┐
│         Claude / ChatGPT / Gemini / Copilot / Cursor            │
└─────────────────────────────────────────────────────────────────┘
                                │
                                │ MCP Protocol (HTTP JSON-RPC)
                                ▼
┌─────────────────────────────────────────────────────────────────┐
│                    Skills MCP Hudu Server                        │
│                        localhost:3100                            │
│  ┌────────────────────────────────────────────────────────────┐ │
│  │                      Express + MCP SDK                     │ │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐      │ │
│  │  │Companies │ │  Assets  │ │Passwords │ │ Articles │      │ │
│  │  │          │ │          │ │          │ │          │      │ │
│  │  └──────────┘ └──────────┘ └──────────┘ └──────────┘      │ │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐      │ │
│  │  │ Networks │ │Procedures│ │  Racks   │ │  Search  │      │ │
│  │  └──────────┘ └──────────┘ └──────────┘ └──────────┘      │ │
│  └────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
                                │
                                │ Hudu REST API
                                ▼
┌─────────────────────────────────────────────────────────────────┐
│                        Hudu Platform                             │
│                  https://your-hudu-instance.com                  │
└─────────────────────────────────────────────────────────────────┘

______________________________________________________________________

🚀 快速开始

先决条件

• Node.js 18+ 或Docker
• Hudu 实例 具有API访问权限
• API密钥 来自Hudu管理面板

安装

选项1:Docker（推荐）

# Clone the repository
git clone https://github.com/DevSkillsIT/Skills-MCP-Hudu.git
cd Skills-MCP-Hudu

# Configure environment
cp .env.example .env
nano .env  # Edit with your Hudu credentials

# Start with Docker Compose
docker-compose up -d

# Verify it's running
curl http://localhost:3100/health

选项2:Node.js

# Clone and install
git clone https://github.com/DevSkillsIT/Skills-MCP-Hudu.git
cd Skills-MCP-Hudu
npm install

# Configure
cp .env.example .env
nano .env  # Edit with your Hudu credentials

# Build and run
npm run build
npm start

# Or development mode with hot reload
npm run dev

GLPI配置

1.获取Hudu API密钥：

• 登录Hudu
• 导航至 管理员 → API密钥
• 点击 生成新的API密钥
• 立即复制密钥（仅显示一次！）

环境设置

# Required Settings
HUDU_BASE_URL=https://your-company.huducloud.com
HUDU_API_KEY=your-api-key-here

# MCP Server Configuration
MCP_SERVER_PORT=3100
MCP_BEARER_TOKEN=your-secure-token  # Optional but recommended

# Optional Settings
HUDU_TIMEOUT=30000
HUDU_ALLOWED_COMPANY_IDS=ALL  # Or specific company IDs: 123,456
LOG_LEVEL=info

连接到克劳德代码

# Add MCP server
claude mcp add --transport http hudu http://localhost:3100/mcp

备选方案：编辑 ~/.claude/settings.json:

{
  "mcpServers": {
    "hudu": {
      "type": "streamable-http",
      "url": "http://localhost:3100/mcp"
    }
  }
}

连接到Gemini CLI

编辑 ~/.gemini/settings.json:

{
  "mcpServers": {
    "hudu": {
      "httpUrl": "http://localhost:3100/mcp",
      "timeout": 30000
    }
  }
}

注： Gemini CLI使用 httpUrl 而不是 url.

测试连接

# Health check
curl http://localhost:3100/health

# Server info
curl http://localhost:3100/

# List available tools (requires valid setup)
curl -X POST http://localhost:3100/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

______________________________________________________________________

🧰 43工具

所有工具都遵循针对ToolRAG系统优化的标准化命名约定：

• 前缀： hudu_ （服务器命名空间）
• 动词： manage （CRUD）或 search （只读查询）
• 描述： 葡萄牙语（pt BR），名词优先用于嵌入相似性，250-350个字符
• 注释： 所有工具都有MCP注释(readOnlyHint, destructiveHint, openWorldHint)
• 输出： Markdown格式的表格和详细视图（不是原始JSON）

📊 公司（2个工具）

💻 IT资产（2个工具）

📝 文章和知识库（2个工具）

🔐 密码和凭据（2个工具）

✅ 程序和检查表（4个工具）

📁 组织（2个工具）

🌐 网络基础设施（8个工具）

📦 数据中心和存储（8个工具）

📅 过期跟踪（1个工具）-- *新*

🌐 网站监控（2个工具）-- *新*

🏗️ 资产布局模板（2个工具）-- *新*

📋 活动审核日志（1个工具）-- *新*

🔗 实体关系（2个工具）-- *新*

📊 Magic Dash小工具（2个工具）-- *新*

🔍 实用程序（3个工具）

______________________________________________________________________

💡 使用示例

提示： 在多个MCP的提示开头提到“Hudu”以保持清晰。

IT文档管理

Hudu, list all companies
Hudu, create a new company "Acme Corporation" with website acme.com
Hudu, show me all assets for company "Acme Corporation"
Hudu, search for articles about "firewall configuration"

密码和凭据管理

Hudu, list all passwords for company "Acme Corporation"
Hudu, create a new password entry for "Office WiFi"
Hudu, search credentials containing "admin"

程序和工作流程

Hudu, list all procedures
Hudu, create a new procedure "Server Backup Checklist"
Hudu, show tasks for procedure ID 123

网络文档

Hudu, list all networks
Hudu, show VLANs for company "Acme Corporation"
Hudu, list IP addresses in network ID 456
Hudu, document rack storage in datacenter

过期跟踪和网站监控

Hudu, show all expiring SSL certificates
Hudu, list domain expirations for company "Acme Corporation"
Hudu, show monitored websites and their DNS/SSL status
Hudu, add website monitoring for https://acme.com

审计和活动日志

Hudu, show recent activity logs for user admin@acme.com
Hudu, list all changes to assets in the last week
Hudu, who modified company "Acme Corporation" recently?

仪表板和关系

Hudu, list all Magic Dash widgets for company "Acme"
Hudu, create a dashboard widget showing backup status
Hudu, show relations between asset ID 100 and other entities

全局搜索

Hudu, search for "firewall" across all resources
Hudu, find anything related to "backup server"

______________________________________________________________________

🔐 MCP资源

通过本地MCP资源URI直接访问数据。所有资源都返回Markdown格式的内容。

Claude Code中的示例用法：

Show me the contents of hudu://companies
Read hudu://assets/42
What does hudu://articles/15 contain?

______________________________________________________________________

📋 MCP提示

常见工作流的预配置提示：

hudu_security_audit

在您的Hudu实例中生成全面的安全审计报告。

hudu_asset_report

使用统计数据创建详细的IT资产库存报告。

用途：

Run the hudu_security_audit prompt for our infrastructure

______________________________________________________________________

⚙️ 配置

环境变量

多租户配置（MSP）

限制访问特定公司：

# Access all companies (default)
HUDU_ALLOWED_COMPANY_IDS=ALL

# Access only company ID 123
HUDU_ALLOWED_COMPANY_IDS=123

# Access multiple companies
HUDU_ALLOWED_COMPANY_IDS=123,456,789

端点

______________________________________________________________________

🔒 安全

最佳实践

• ✅ 将API密钥存储在 .env 文件，从不在代码中
• ✅ 在生产环境中使用HTTPS （使用SSL/TLS的反向代理）
• ✅ 集 MCP_BEARER_TOKEN 用于HTTP身份验证
• ✅ 限制网络访问 仅限可信来源
• ✅ 定期旋转API密钥
• ✅ 使用只读API密钥 当不需要写访问权限时
• ✅ 启用公司筛选 适用于多租户环境

速率限制

内置速率限制保护您的Hudu实例：

• 违约： 每15分钟每IP 1000个请求
• 可通过环境变量进行配置
• 自动回退并重试

CORS配置

CORS已预先配置为安全的本地网络访问：

• localhost 和 127.0.0.1
• 专用网络范围（10.x.x.x、172.16.x.x、192.168.x.x）
• 通过以下方式定制原产地 MCP_ALLOWED_ORIGINS

______________________________________________________________________

🐳 Docker部署

Docker Compose（推荐）

version: '3.8'

services:
  hudu-mcp:
    build: .
    container_name: skills-mcp-hudu
    restart: unless-stopped
    ports:
      - "3100:3100"
    environment:
      - HUDU_BASE_URL=${HUDU_BASE_URL}
      - HUDU_API_KEY=${HUDU_API_KEY}
      - MCP_SERVER_PORT=3100
      - MCP_BEARER_TOKEN=${MCP_BEARER_TOKEN}
      - HUDU_TIMEOUT=30000
      - LOG_LEVEL=info
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3100/health"]
      interval: 30s
      timeout: 10s
      retries: 3

Docker命令

# Build and start
docker-compose up -d --build

# View logs
docker-compose logs -f hudu-mcp

# Stop
docker-compose down

# Rebuild without cache
docker-compose build --no-cache

# Check status
docker-compose ps

______________________________________________________________________

🐛 故障排除

常见问题

调试模式

启用详细日志记录：

# .env
LOG_LEVEL=debug

日志

Docker：

docker-compose logs -f hudu-mcp

Node.js：

# Logs are written to stdout/stderr
npm start 2>&1 | tee hudu-mcp.log

PM2：

pm2 logs hudu-mcp

______________________________________________________________________

🧪 测试与开发

开发设置

# Clone repository
git clone https://github.com/DevSkillsIT/Skills-MCP-Hudu.git
cd Skills-MCP-Hudu

# Install dependencies
npm install

# Start development server (hot reload)
npm run dev

# Run linting
npm run lint

# Type checking
npm run type-check

# Build for production
npm run build

测试命令

# Run all tests (179 tests, 12 suites)
npm test

# Run with verbose output
NODE_OPTIONS='--experimental-vm-modules' npx jest --verbose

# Type checking
npm run type-check

# Lint code
npm run lint

# Build project
npm run build

测试覆盖率

______________________________________________________________________

📁 项目结构

Skills-MCP-Hudu/
├── src/
│   ├── index.ts              # Entry point
│   ├── server.ts             # MCP HTTP server + instructions + resource handlers
│   ├── hudu-client.ts        # Hudu API client (941 lines, all endpoints + fetchAll)
│   ├── resources.ts          # MCP Resources handler (6 hudu:// URIs) — NEW
│   ├── types.ts              # TypeScript definitions + HuduPagedResponse
│   ├── utils/
│   │   └── html-stripper.ts  # HTML cleanup: stripHtml, truncate, escapeMarkdown — NEW
│   ├── formatters/
│   │   ├── markdown.ts       # 29 Markdown formatters for all entity types — NEW
│   │   └── response-formatter.ts  # Global interceptor: Markdown for all 43 tools — NEW
│   └── tools/
│       ├── working-index.ts  # Primary tool registry (43 tools)
│       ├── base.ts           # Response helpers
│       ├── schema-utils.ts   # Shared schemas and properties
│       ├── companies.ts      # Company management (2 tools)
│       ├── assets.ts         # Asset inventory (2 tools)
│       ├── articles.ts       # Knowledge base articles (2 tools)
│       ├── passwords.ts      # Password vault (2 tools)
│       ├── procedures.ts     # Procedures and tasks (4 tools)
│       ├── folders.ts        # Folder organization (2 tools)
│       ├── networks.ts       # Networks, VLANs, IPs (8 tools)
│       ├── storage.ts        # Uploads, racks, photos (8 tools)
│       ├── expirations.ts    # Expiration tracking (1 tool) — NEW
│       ├── websites.ts       # Website monitoring (2 tools) — NEW
│       ├── asset-layouts.ts  # Asset layout templates (2 tools) — NEW
│       ├── activity-logs.ts  # Activity audit logs (1 tool) — NEW
│       ├── relations.ts      # Entity relations (2 tools) — NEW
│       ├── magic-dash.ts     # Dashboard widgets (2 tools) — NEW
│       ├── admin.ts          # Instance administration (1 tool)
│       ├── search.ts         # Global unified search (1 tool)
│       └── navigation.ts     # Quick navigation (1 tool)
├── src/__tests__/            # 179 tests across 12 suites — NEW
│   ├── utils/                # html-stripper tests
│   ├── formatters/           # markdown + response-formatter tests
│   ├── tools/                # Tool executor tests (6 files)
│   ├── integration/          # Registry + annotation compliance tests
│   └── resources.test.ts     # MCP Resources tests
├── dist/                     # Compiled JavaScript (generated)
├── jest.config.ts            # Jest configuration (ESM + ts-jest) — NEW
├── tsconfig.test.json        # TypeScript config for tests — NEW
├── hudu.json                 # Hudu OpenAPI spec (reference)
├── Dockerfile                # Multi-stage Docker build
├── docker-compose.yml        # Docker Compose configuration
├── package.json              # Node.js dependencies
├── tsconfig.json             # TypeScript configuration
├── .env.example              # Environment template
├── .gitignore                # Git ignore rules
├── LICENSE                   # MIT License
└── README.md                 # This file

______________________________________________________________________

🤝 贡献

我们欢迎捐款！以下是如何参与其中：

1. 分叉 存储库
2. 创建 您的功能分支： git checkout -b feature/AmazingFeature
3. 提交 您的更改： git commit -m 'feat: add amazing feature'
4. 推 分支机构： git push origin feature/AmazingFeature
5. 打开 拉取请求

承诺标准

我们跟随 常规提交:

feat: add new feature
fix: correct bug
docs: update documentation
refactor: improve code structure
test: add tests
chore: update dependencies
style: formatting changes
perf: performance improvements

开发指南

• 编写干净、有文档记录的TypeScript代码
• 遵循现有的代码风格和模式
• 为新功能添加测试
• 根据需要更新文档
• 提交PR前使用Claude Code进行测试

______________________________________________________________________

📚 实用链接

• 沪都官方网站 -IT文档平台
• Hudu API 文档 -REST API文档
• MCP规范 -模型上下文协议
• 技能IT网站 -我们公司
• MCP TypeScript SDK -官方SDK

______________________________________________________________________

📞 支持

错误报告

发现bug了吗？请 打开一个问题 与：

• 问题描述
• 重现步骤
• 预期行为与实际行为
• 环境详细信息（Node.js版本、操作系统、Hudu版本）
• 相关日志（删除敏感数据）

讨论

有问题或想法吗？加入我们

电子邮件

技术支持：contato@skillsit.com.br

______________________________________________________________________

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

______________________________________________________________________

🙏 致谢

• 胡图 -令人惊叹的IT文档平台
• Anthropic -适用于Claude和MCP规范
• 模型上下文协议 -使这成为可能的协议
• MSP社区 -用于反馈和功能请求

______________________________________________________________________

制造于❤️ by Skills IT - IT解决方案 - 中国

*我们是一家MSP，为其他MSP提供智能自动化。*

版本： 1.2.0 | 最后更新时间： 2026年3月

🇧🇷 自豪地在巴西制造

⬆ 返回页首