ioffice-mcp

Name: ioffice-mcp
Author: chrischall

本地服务

github.com/chrischall商业与营销14 天前更新

代码仓库

关于 ioffice-mcp

ioffice-mcp 将 Claude 接入 iOffice 工作空间管理，可用于预订房间、管理访客和维护工单，并为状态变更操作设置确认保护。

主要功能

01预订房间
02管理访客
03处理维护工单
04写入前确认变更
05预览目标记录的变更

适用场景

01预订工作空间会议室
02管理访客记录
03提交或跟进维护工单
04检查待执行的更新或删除

MCP 相关

通过 MCP 服务向 Claude 提供 iOffice 工作空间管理操作。写入和状态变更操作会按客户端能力要求确认，或返回预览及一次性令牌。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "chrischall-ioffice": {
      "command": "npx",
      "args": [
        "-y",
        "ioffice-mcp"
      ],
      "env": {
        "IOFFICE_HOST": "<IOFFICE_HOST>",
        "IOFFICE_TOKEN": "<IOFFICE_TOKEN>",
        "IOFFICE_USERNAME": "<IOFFICE_USERNAME>",
        "IOFFICE_PASSWORD": "<IOFFICE_PASSWORD>"
      }
    }
  }
}

启动命令npx -y ioffice-mcp

需要配置的环境变量

IOFFICE_HOSTYour iOffice tenant hostname (e.g. yourcompany.ioffice.com)

IOFFICE_TOKEN密钥Your iOffice API token (preferred over username/password)

IOFFICE_USERNAMEYour iOffice username (used if no API token)

IOFFICE_PASSWORD密钥Your iOffice password (used if no API token)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmioffice-mcp3.2.6stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
view	enum	否	响应格式："compact"（默认）会省略响应中其他位置已包含的字段；"full" 会返回此服务器支持的所有字段。compact 会从响应中移除图像/头像 URL；"full" 会原样返回 iOffice 的负载。不支持字段投影：此服务器没有经过验证的记录来说明哪些 iOffice 字段重要，臆造字段列表可能会导致调用方需要的字段被丢弃。compact \| full
limit	integer	否	最大结果数（默认值为 50，最大为 100）
search	string	否	按名称或说明筛选
orderBy	string	否	排序依据的属性（默认为：id）
startAt	integer	否	分页偏移量（默认 0）
orderByType	enum	否	排序方向（默认：asc）asc \| desc

详细介绍

ioffice-mcp

面向 Claude 的 iOffice MCP 服务——由 AI（Claude Code）开发和维护

确认

每个写入和状态变更工具（共 34 个）都会先请求用户确认。能够显示确认提示词的客户端（Claude Code）会显示实际提示词，除非 MCP_CONFIRM_ELICITATION=off。对于无法显示提示词的客户端（claude.ai、Claude Desktop），首次调用不会写入任何内容，而是返回预览——包括将要发送的方法、路径和确切内容——以及一个一次性使用的 confirmToken；只有再次携带该令牌调用才会执行写入，如果期间任何参数发生变化，令牌就会被拒绝。

更新、删除、io_cancel_move 或 io_return_mail 会先读取目标记录，因此其预览（和提示词）会说明具体变更内容—— 例如 Delete iOffice user 42 (Alice Smith) 并附上她的电子邮件，而不只是 ID——如果预览后该记录被修改，令牌也会被拒绝。不存在的 ID 会在读取时失败，不会生成预览。

变量	默认值
`MCP_CONFIRM_MODE`	`ask-user`	在无法显示确认提示词的客户端（claude.ai、Claude Desktop）上，写入操作的处理方式。`ask-user`：分两步执行——首次调用不会写入任何内容，而是返回预览和令牌；模型必须先在聊天中取得你的批准，再携带令牌再次调用。`auto`：同样分两步执行，但模型查看预览后可以使用令牌。`refuse`：此类客户端上的写入操作会被拒绝。能够显示提示词的客户端（Claude Code）始终会收到实际提示词，除非 `MCP_CONFIRM_ELICITATION=off`。无法识别的值会按 `refuse` 处理。
`MCP_CONFIRM_ELICITATION`	`on`	`off` 时永不显示确认提示词，因此所有客户端都会采用 `MCP_CONFIRM_MODE` 的行为。如果某客户端声称能够显示提示词却从不显示（写入操作会挂起——opencode 2.0.x），请设置此变量。其他任何值均按 `on` 处理，并在 stderr 上显示警告。
`MCP_CONFIRM_TTL_SECONDS`	`600`	令牌的有效时长。
`MCP_CONFIRM_SECRET`	每个进程随机生成	签名密钥；仅当令牌必须在服务重启后继续有效时才设置。