Utelogy MCP Server

MCP运维云端

提供方 American-Sound

运维云端 未标注 无需鉴权 社区 / 第三方 Claude

一个本地运行的MCP服务器,为AI编码助手提供直接访问Utelogy U-Manage门户REST API的功能,涵盖房间、资产、警报和全局设备库。

一句话选型结论

按资料字段整理

Utelogy MCP Server 属于运维云端类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 13 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量13暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

AI编码助手TypeScript本地部署RESTAPI本地运行设备管理警报处理

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 13 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 13 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Utelogy MCP Server当前 13 未标注 未标注 无 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方American-Sound上游标注的维护方 American-Sound
分类运维云端本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.0 KB
来自项目仓库与上游目录的原文,未做删改

子宫MCP服务器

MCP服务器,为AI编码助手提供对Utelogy U-Manage门户网站REST API的直接访问,涵盖房间、资产、警报和全球设备库。它完全使用Deno在您的本地计算机上运行,通过stdio进行通信,并使用您提供的凭据连接到您自己的Utlogy门户帐户。没有任何内容是通过American Sound或任何第三方托管、代理或路由的。

此服务器是开源的,任何拥有Utelogy门户帐户和API凭据的人都可以使用(Utelogy平台本身不是开源的,您必须拥有有效的Utelogy订阅才能访问REST API)。您不需要是American Sound的客户就可以使用它。该项目由American Sound在Utlogy的知识和许可下开发。American Sound全权负责支持这一整合。Utlogy不直接支持第三方平台和服务。

支持的AI平台

American Sound在以下AI编码助手的付费计划上测试并支持此服务器:

  • 克劳德代码 和 克劳德桌面版 (Anthropic)关于Max、团队和企业计划
  • OpenAI Codex命令行界面 关于OpenAI付费计划

这些平台上的免费层计划可能适用于MCP服务器,但American Sound不会针对免费层配置进行测试,也不会为其提供集成支持。如果您首选的AI助手将来添加了MCP支持,则此服务器应无需修改即可使用它,尽管我们只有在内部验证后才会将其添加到我们支持的平台列表中。

它的作用

服务器公开了13个映射到Utelogy REST API核心端点的工具。API是只读的,但有一个例外:警报确认是Utelogy通过其REST接口公开的唯一写入操作。

这些工具涵盖四个领域:

  • 警报 通过可选的日期过滤列出活动和历史警报,并按ID确认警报
  • 资产 列出所有受监视的设备并检索特定资产的详细信息
  • 房间 列出已配置的房间,获取房间详细信息,并提取每个房间的警报状态
  • 全局设备库 按关键字查询制造商、设备种类、功能种类、驱动程序和搜索驱动程序

所有API调用的速率限制为每10秒一个请求。限制器在模块级别强制执行这一点,因此背靠背的工具调用按顺序排队和执行,而不是淹没门户API。

本地安装

此服务器在您的计算机上本地运行。它不是云服务,没有托管版本,American Sound除了我们自己的内部使用外,不会操作或访问此服务器的任何实例。您的Utelogy凭据保留在您的计算机上,并通过HTTPS直接传递到Utelogy门户API。

先决条件

  • 德诺 运行时(v1.40+)
  • 具有API访问权限的Utelogy门户帐户
  • 您的Utelogy API密钥和Base64编码的授权头(可从您的Utelogy门户帐户设置中获得)

设置

将此存储库克隆到本地计算机:```bash
git clone https://github.com/American-Sound/utelogy-mcp-server.git


将服务器添加到MCP客户端的配置中。大多数客户端接受类似于以下内容的JSON格式:```json
{
"mcpServers": {
"utelogy": {
"command": "deno",
"args": [
"run",
"--allow-net=portal.utelogy.com",
"--allow-env",
"server.ts"
],
"cwd": "/path/to/utelogy-mcp-server",
"env": {
"UTELOGY_API_KEY": "your-api-key",
"UTELOGY_AUTHORIZATION": "your-base64-auth"
}
}
}
}

这 --allow-net=portal.utelogy.com 标志仅限制服务器对子宫科门户的网络访问。您可以使用更广泛的 --allow-net 如果您的门户在自定义域上运行,但将权限范围限定到特定主机是更安全的默认设置。

您还可以直接运行服务器以验证其是否启动:bash deno run --allow-net --allow-env server.ts

服务器将等待stdin上的MCP工具调用。在正常使用中,您的AI助手会通过MCP配置自动启动它。

凭证解析

每个工具都接受可选的凭据参数,但您不需要在每次调用时都提供这些参数。服务器通过两层回退来解析凭据:

  1. 显式参数 (apiKey, authorization, baseUrl)直接在工具调用中传递覆盖一切。当您需要针对特定帐户或使用不同凭据进行测试时,请使用此选项。
  2. 环境变量 (UTELOGY_API_KEY, UTELOGY_AUTHORIZATION, UTELOGY_BASE_URL)当没有提供显式凭据时,将其设置为默认值。这是标准配置路径。

基本URL默认为 https://portal.utelogy.com 如果没有通过任何一层提供。

凭证安全: MCP客户端配置以明文JSON存储在磁盘上(例如。, ~/.claude.json 克劳德代码)。确保您的配置文件具有适当的文件权限(chmod 600 在Linux/macOS上),并且永远不要将其提交给源代码管理。如果您的组织使用secrets管理器,请考虑在运行时将凭据作为环境变量注入,而不是直接将其存储在配置文件中。

工具参考

警报

工具 说明
list-active-alerts 列出所有受监控设备上当前所有活动(未确认)的警报
list-alerts 使用可选日期范围过滤器列出警报(ISO 8601日期时间)
acknowledge-alert 通过ID确认活动警报(写入操作)

资产

工具 说明
list-assets 列出所有房间的所有受监控资产(设备)
get-asset 按ID获取特定资产的详细信息

房间

工具 说明
list-rooms 列出子宫科门户中配置的所有房间
get-room 获取详细的房间信息,包括CLM状态和指标
get-room-alerts 列出特定房间的活动警报

全局设备库

工具 说明
list-manufacturers 列出GDL中的所有制造商
list-device-kinds 列出所有设备类别
list-feature-kinds 列出设备功能(功率、音量、输入等)
list-drivers 列出所有可用的设备驱动程序
search-drivers 按关键字搜索驱动程序(制造商名称、型号等)

依赖项

服务器使用通过Deno的npm说明符语法导入的两个npm包:

  • @modelcontextprotocol/sdk@1.12.1 用于MCP服务器框架和stdio传输
  • zod@3.25.1 用于工具参数验证

不 package.json 或 node_modules 需要目录。Deno在第一次运行时获取并缓存这些数据。

速率限制

速率限制器在模块级别强制执行API调用之间的最小10秒间隔。因为每次MCP工具调用都会创建一个新的客户端实例,所以限制器位于客户端类之外,因此它全局应用于服务器会话中的所有工具调用。在窗口内到达的呼叫会延迟而不是被拒绝,因此您不需要在工作流中处理重试逻辑。

间隔配置为 minIntervalMs: 10_000 在 rateLimiter 对象在 utelogy-client.ts.

权限和AI安全

这 acknowledge-alert 工具是此服务器中唯一的写入操作。当您将此服务器连接到AI助手时,助手可以代表您确认警报,而无需额外确认,除非您的MCP客户端配置为需要批准工具调用。

Utelogy的API不支持作用域权限。可以读取房间和资产的API密钥也可以确认警报。无法通过U-Manage门户发布只读密钥。如果您的工作流仅用于监控,请将MCP客户端配置为在执行工具调用之前需要明确批准,或删除 acknowledge-alert 工具注册来自 server.ts 在部署之前。

局限性

Utelogy REST API不公开U-Automate脚本触发,因此此服务器无法启动设备控制操作。警报webhooks(HMAC SHA-256签名,在U-Manage门户中按帐户配置)是此服务器不处理的单独入站集成路径。

API 参考

此服务器包装 通用REST API。所有终结点都需要有效的API密钥和授权标头,您可以从Utelogy门户帐户设置中获取这些密钥和标头。

质量和测试

所有发布到American Sound GitHub组织的软件在发布之前,都经过了他们许可的生产客户端环境或American Sound集成实验室的测试。

联系

Doug Schaefer,美国音响电子股份有限公司首席技术官。

  • github: @道格·谢弗6
  • 领英: linkedin.com/in/dougschaefer
  • 电子邮件:dougschaefer@asei.com

许可证

MIT。看 许可证 了解详情。

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Utelogy MCP Server 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Utelogy MCP Server 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Utelogy MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Utelogy MCP Server 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Utelogy MCP Server 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Utelogy MCP Server 能提供哪些能力?

资料显示约 13 个工具;能力标签包括 本地运行、TypeScript、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。