AI导哈

Hudu文档管理集成工具

连接Claude AI与Hudu IT文档平台的服务，实现知识库、资产、密码等内容的搜索、读取、创建和更新。

  • by Allied-Business-Solutions
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Allied-Business-Solutions/hudu-mcp

使用说明

MCP 服务器

将Claude AI连接到您的 胡图 IT文档平台。安装后，Claude可以直接从任何Claude界面搜索、阅读、创建和更新您的Hudu知识库、资产、密码、公司等。

这有什么作用

此服务器实现 模型上下文协议（MCP），为Claude提供对Hudu REST API的安全、结构化访问。它作为本地stdio进程运行，由Claude Desktop或Claude Code根据需要启动。

可用工具

类别 工具
条款 列表、获取、创建、更新、删除、存档、取消存档
资产 列表（全局+每个公司）、获取、创建、更新、删除、存档、取消存档、移动布局
资产布局 列表、获取、创建、更新
资产密码 列表、获取、创建、更新、删除、存档、取消存档
公司 列表、获取、创建、更新、删除、存档、取消存档
过期 列表、更新、删除
出口 列表、获取、创建
S3导出 创建
标志类型 列表、获取、创建、更新、删除
旗帜 列表、获取、创建、更新、删除
文件夹 列表、获取、创建、更新、删除
群组 列表，获取
IP地址 列表、获取、创建、更新、删除
列表 列表、获取、创建、更新、删除
魔术短跑 列表、追加销售、删除（按标题或ID）、更新职位
匹配器 列表、更新、删除
网络 列表、获取、创建、更新、删除
密码文件夹 列表、获取、创建、更新、删除
照片 列表、获取、创建、更新、删除
公共照片 列表、获取、创建、更新
程序 列表、获取、创建、更新、删除、启动、复制、从模板创建
程序任务 列表、获取、创建、更新、删除
机架式存储 列表、获取、创建、更新、删除
机架存储物品 列表、获取、创建、更新、删除
关系 列表、创建、删除
上传 列表、获取、删除
用户 列表，获取
虚拟局域网 列表、获取、创建、更新、删除
VLAN区域 列表、获取、创建、更新、删除
网站 列表、获取、创建、更新、删除
活动日志 列表，删除
导航 跳到卡片，跳到公司
API信息 获取版本

先决条件

  • Node.js 18或更新版本 — nodejs.org
  • 克劳德桌面版 或 克劳德代码
  • 一个 Hudu API 密钥 --生成一个 胡都管理员→ 基本信息→ API密钥

安装

1.克隆和构建

将仓库克隆到标准安装位置并构建：

git clone https://github.com/Allied-Business-Solutions/hudu-mcp.git "$env:LOCALAPPDATA\Programs\HuduMCP"
cd "$env:LOCALAPPDATA\Programs\HuduMCP"
npm install
npm run build

这将TypeScript源代码编译为 dist/.

2.配置克劳德桌面

打开（或创建）您的Claude Desktop配置文件：

  • 窗户： %APPDATA%\Claude\claude_desktop_config.json
  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

添加 hudu 进入下 mcpServers:

{
  "mcpServers": {
    "hudu": {
      "command": "node",
      "args": ["C:/Users/YOUR_USERNAME/AppData/Local/Programs/HuduMCP/dist/index.js"],
      "env": {
        "HUDU_API_KEY": "your_api_key_here",
        "HUDU_BASE_URL": "https://your-instance.huducloud.com/api/v1"
      }
    }
  }
}

替换 YOUR_USERNAME 使用Windows用户名，然后填写API密钥和Hudu URL。重新启动Claude Desktop。

3.配置克劳德代码

添加 ~/.claude/settings.json （或 .claude/settings.json 在您的项目中）：

{
  "mcpServers": {
    "hudu": {
      "command": "node",
      "args": ["C:/Users/YOUR_USERNAME/AppData/Local/Programs/HuduMCP/dist/index.js"],
      "env": {
        "HUDU_API_KEY": "your_api_key_here",
        "HUDU_BASE_URL": "https://your-instance.huducloud.com/api/v1"
      }
    }
  }
}

替换 YOUR_USERNAME 使用Windows用户名，然后填写API密钥和Hudu URL。

环境变量

变量 描述
HUDU_API_KEY 您的Hudu API密钥（来自Hudu管理员→ 基本信息→ API密钥）
HUDU_BASE_URL 您的Hudu实例API基础URL，例如。 https://your-instance.huducloud.com/api/v1

看 .env.example 对于模板。

示例提示

连接后，您可以问Claude以下问题：

“在Hudu上搜索有关VPN设置的任何文章，并总结我们的内容”

“查找Acme Corp的所有资产并列出其序列号”

“在Acme Corp公司下创建一篇名为“Windows 11部署指南”的新文章，其中包含以下步骤：[粘贴步骤]”

“查找Acme防火墙管理员帐户的密码条目”

“我们记录了哪些新员工入职程序？”

“显示未来30天内即将到期的所有SSL证书”

故障排除

工具未出现在Claude中 验证配置文件是否为有效的JSON和路径 dist/index.js 正确（例如。 C:/Users/YOUR_USERNAME/AppData/Local/Programs/HuduMCP/dist/index.js).更改任何配置后重新启动Claude Desktop。

HUDU_API_KEY is required 错误 这 env Claude配置中的块缺失或键名错误。检查它是否准确 HUDU_API_KEY.

HUDU_BASE_URL is required 错误 同样——检查一下 HUDU_BASE_URL 已设置并以结尾 /api/v1.

401未经胡都授权 您的API密钥无效或已过期。从Hudu Admin生成一个新的→ 基本信息→ API密钥。

找不到Node.js 从以下位置安装Node.js 18+ nodejs.org 并重新启动您的终端/Claude Desktop。

发展

npm run build    # compile TypeScript → dist/
npm run dev      # watch mode (recompiles on save)
npm start        # run the compiled server

文件结构

hudu-mcp/
├── src/
│   ├── api.ts       ← HTTP client helpers
│   ├── tools.ts     ← MCP tool definitions
│   └── index.ts     ← Server entry point + tool dispatch
├── dist/            ← Compiled output (git-ignored)
├── reference/
│   └── HuduRESTAPI.json  ← Hudu OpenAPI spec
├── package.json
├── tsconfig.json
├── .env.example
├── .gitignore
└── README.md

贡献

要添加新工具，请执行以下操作：

  1. 添加一个 Tool 进入 TOOLS 数组in src/tools.ts
  2. 添加相应 case 到 callTool 切换 src/index.ts
  3. 跑 npm run build 验证它是否编译

这 API 文档 描述所有可用端点。

许可证

麻省理工学院

相关 MCP