GLPI (Mojood Connect)

GLPI MCP 服务

用日常语言向 Claude 询问 IT 服务台和资产情况：哪些事项紧急、由谁负责，某人持有哪些资产以及其中是否有损坏的，工单写了什么。你还可以在同一聊天中添加跟进并重新分派工单，任何变更前都会先进行确认。

由 Mojood Connect 构建，作为适用于 GLPI 的可运行演示。它通过 REST API 连接任何 GLPI 9.5–12。本仓库附带一套本地 GLPI，其中包含虚构公司 Harbor Trading IT 部门的示例数据，你可以在不触及真实实例的情况下试用。

工具

工具	功能	是否会更改内容？
find_tickets	查找工单，按优先级从高到低排列：状态、请求者、技术人员、群组、截止时间、关联资产	否
get_ticket	获取单个工单及其描述和按顺序排列的所有跟进，私密跟进会标明	否
person_overview	查看某人持有的资产（状态，以及每项资产相关的未结工单）和此人提出的工单	否
needs_attention	查找无人负责、已超过解决时限、高优先级及以上、等待请求者回复的工单	否
add_followup	为工单添加跟进：除非另有要求，否则仅技术人员可见	是，需确认后执行
update_ticket	重新分派给某个群组、添加技术人员或更改优先级	是，需确认后执行

如何确保变更安全。 调用 add_followup 或 update_ticket 时如果没有提供 confirmation，不会更改任何内容：它会返回一段简单摘要（“在 #1（‘利雅得办公室的 VPN 每 10 分钟断开一次’）上：将其重新分派给 Network team（原为 Service desk）。”）以及一个一次性代码。只有在 10 分钟内使用该代码再次提交相同请求，变更才会生效。代码只能使用一次，且仅对发放该代码的请求有效。服务的指令会告诉模型展示摘要并等待用户确认。跟进会附带“via Claude (Mojood Connect demo)”，GLPI 会以登录用户的身份在工单历史记录中记录每次变更。

服务以一个 GLPI 用户身份登录，并按照该用户的个人资料和权限执行操作。

本地试用

需要 Docker（含 Compose）、uv 和 Python 3.13。

scripts/reset.sh                         # local GLPI on http://localhost:8095, filled with the SAMPLE helpdesk
uv run --env-file .env glpi-mcp          # MCP server on http://127.0.0.1:8006/mcp (Streamable HTTP)

docker/compose.yml 参考 GLPI 自带的 docker-compose.example.yml（glpi-project/docker-images），固定使用 GLPI 12.0.1 和 MySQL 8.4，仅监听 127.0.0.1，并使用 UTC 时区。scripts/up.sh 会为 GLPI 的默认账户（glpi、tech、normal、post-only）生成密码，创建演示用 API 用户并启用 REST API；所有密码都保存在被 git 忽略的文件 docker/.env 和 .env 中，不会打印出来。

**Claude Desktop：**将以下内容添加到 claude_desktop_config.json（Settings › Developer），并将路径替换为此文件夹的路径：

{
  "mcpServers": {
    "glpi": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/glpi-mcp", "--env-file", "/path/to/glpi-mcp/.env", "glpi-mcp", "--stdio"]
    }
  }
}

然后询问：“有哪些紧急工单尚未关闭，分别由谁负责？”“Sara 持有哪些资产，其中有没有损坏的？”“在 VPN 工单中添加备注，说明防火墙日志指向 IPsec 隧道，并将工单重新分派给网络团队。”

**使用你自己的 GLPI：**设置 GLPI_URL、GLPI_LOGIN、GLPI_PASSWORD（GLPI 用户；在 Setup › General › API 中启用 REST API 和登录凭据访问），并将 GLPI_SAMPLE 设为 0。

示例服务台

Harbor Trading 的 IT 部门：三个站点、三个群组（Service desk、Network team、Field support）、四名技术人员、八名员工、16 项资产（笔记本电脑、显示器、手机、仓库扫描仪）和十张工单。时间会根据数据生成时的时间设置，因此始终会有一起无人负责的重大事件、两张已超过截止时间的工单、一张等待请求者回复的工单，以及一些已解决的历史工单。所有人员和内容均为虚构。

测试

uv run --env-file .env pytest            # unit tests (a fake GLPI API), plus live tests when the local GLPI runs

生产版本增加的功能

此演示以单个用户身份登录。面向 GLPI 客户的生产级服务会增加通过 GLPI 11+ OAuth 让每位技术人员登录的功能，以便 Claude 只看到他们有权访问的实体和个人资料；提供托管服务，并记录每次工具调用的审计日志；还会接入更多 API（问题和变更、知识库、合同、软件和许可证）。Mojood Connect 正是为此打造的。

许可证

Apache 2.0。GLPI 是 Teclib' 的商标；本项目并非由 Teclib' 制作或认可。