四-MCP
MCP（模型上下文协议）服务器 胡图 IT文档平台。提供39个工具和6个资源，用于通过任何兼容MCP的客户端管理公司、资产、文章、密码、网站等。
特性
- 39个MCP工具 涵盖所有主要的湖都资源
- 6 MCP资源 用于直接数据访问
- 双重运输 支持：stdio（默认）和HTTP Streamable
- 惰性初始化 -第一次工具调用时创建的SDK客户端
- 连接测试 内置的
- 所有日志记录到stderr 避免污染MCP标准传输
一键部署
安装
git clone https://github.com/wyre-technology/hudu-mcp.git
cd hudu-mcp
npm install
npm run build
配置
| 变量 | 必填 | 默认 | 描述 |
|---|
HUDU_BASE_URL | 是 | - | 您的Hudu实例URL（例如。， https://docs.example.com) |
HUDU_API_KEY | 是 | - | 您的Hudu API密钥 |
MCP_TRANSPORT | 没有 | stdio | 运输类型： stdio 或 http |
MCP_HTTP_PORT | 没有 | 8080 | HTTP服务器端口（使用时 http 运输） |
MCP_HTTP_HOST | 没有 | 0.0.0.0 | HTTP服务器主机 |
MCP_SERVER_NAME | 没有 | hudu-mcp | 向MCP客户端报告的服务器名称 |
MCP_SERVER_VERSION | 没有 | 1.0.0 | 向MCP客户端报告的服务器版本 |
LOG_LEVEL | 没有 | info | 日志级别： error, warn, info, debug |
LOG_FORMAT | 没有 | simple | 日志格式： json 或 simple |
用法
克劳德桌面（stdio）
添加到您的 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传输
HUDU_BASE_URL=https://docs.example.com \
HUDU_API_KEY=your-api-key \
MCP_TRANSPORT=http \
MCP_HTTP_PORT=8080 \
npm start
工具（39）
公司（8种工具）
| 工具 | 说明 |
|---|
hudu_list_companies | 列出具有可选筛选器的公司 |
hudu_get_company | 通过ID获取公司 |
hudu_create_company | 创建新公司 |
hudu_update_company | 更新现有公司 |
hudu_delete_company | 删除公司 |
hudu_archive_company | 将公司存档 |
hudu_unarchive_company | 解散一家公司 |
hudu_test_connection | 测试与Hudu API的连接 |
资产（6个工具）
| 工具 | 说明 |
|---|
hudu_list_assets | 列出带有可选筛选器的资产 |
hudu_get_asset | 按ID获取资产 |
hudu_create_asset | 创建新资产 |
hudu_update_asset | 更新现有资产 |
hudu_delete_asset | 删除资产 |
hudu_archive_asset | 存档资产 |
资产布局（4个工具）
| 工具 | 说明 |
|---|
hudu_list_asset_layouts | 列出资产布局 |
hudu_get_asset_layout | 按ID获取资产布局 |
hudu_create_asset_layout | 创建新的资产布局 |
hudu_update_asset_layout | 更新现有资产布局 |
资产密码（5个工具）
| 工具 | 说明 |
|---|
hudu_list_asset_passwords | 列出资产密码 |
hudu_get_asset_password | 通过ID获取资产密码 |
hudu_create_asset_password | 创建新的资产密码 |
hudu_update_asset_password | 更新现有资产密码 |
hudu_delete_asset_password | 删除资产密码 |
文章（6工具）
| 工具 | 说明 |
|---|
hudu_list_articles | 列出知识库文章 |
hudu_get_article | 按ID获取文章 |
hudu_create_article | 创建新文章 |
hudu_update_article | 更新现有文章 |
hudu_delete_article | 删除文章 |
hudu_archive_article | 将文章存档 |
网站（5个工具）
| 工具 | 说明 |
|---|
hudu_list_websites | 列出受监控的网站 |
hudu_get_website | 按ID获取网站 |
hudu_create_website | 创建新网站 |
hudu_update_website | 更新现有网站 |
hudu_delete_website | 删除网站 |
其他资源（5个工具）
| 工具 | 说明 |
|---|
hudu_list_folders | 列出文件夹 |
hudu_list_procedures | 列出程序 |
hudu_list_activity_logs | 列出活动日志 |
hudu_list_relations | 列出关系 |
hudu_list_magic_dash | 列出Magic Dash项目 |
资源
| URI | 描述 |
|---|
hudu://companies | 所有公司列表 |
hudu://companies/{id} | 按ID列出的公司详细信息 |
hudu://assets | 所有资产清单 |
hudu://assets/{id} | 按ID列出的资产详细信息 |
hudu://articles | 所有文章列表 |
hudu://articles/{id} | 按ID列出的文章详细信息 |
发展
# Install dependencies
npm install
# Build
npm run build
# Run in development mode
npm run dev
# Clean build output
npm run clean
许可证
阿帕奇-2.0
