eeo-oa-workflow-mcp

中文文档
0.5.0发布于 2026/11/03UNLICENSEDES Module

翼鸥 OA 流程中心 MCP 服务

原始使用文档
文档目录3 节
  1. 工具
  2. 环境变量
  3. 配置示例

翼鸥 OA 流程中心 MCP

通过翼鸥公共 API Key 使用 OA 流程中心的 STDIO MCP 服务。服务端根据 API Key 识别当前员工并校验数据权限。

工具

工具编码中文名称类型
start_process发起 OA 流程写操作
workflow_statistics流程统计只读
notice_statistics我的知会统计只读
list_todo_tasks我的待办只读
list_done_tasks我的已办只读
list_notices我的知会只读
list_expected_todos预计待办只读
get_process_data查询单条流程数据只读
execute_workflow_task执行流程任务写操作
send_workflow_notice发送知会写操作
list_ai_operation_logs获取 AI 操作记录只读
get_task_buttons查询流程任务按钮只读
get_approval_field_options查询审批字段动态选项只读
list_drafts草稿箱只读
list_applications我的申请只读
application_statistics我的申请统计只读
query_departments部门信息查询只读
query_employees员工信息查询只读
query_dictionary数据词典查询只读
download_attachment附件下载本地写入
upload_attachment附件上传OA 写入

工具内部编码使用 MCP 兼容的英文下划线格式;客户端展示的标题、描述和参数说明均为中文。

start_process 当前支持 BPM工单。调用方只需传问题类型和问题描述;提交人、主部门和联系方式由 MCP 根据当前 API Key 的个人信息自动补齐。该工具会直接发起流程,不保存草稿。

环境变量

API_KEY=<翼鸥公共 API Key>
OA_BASE_URL=<OA 环境地址>

OA_BASE_URL 不是安全凭据,主要用于切换生产、测试等不同 OA 环境。不要把 API_KEY 写入源码、包配置或 Git。

可选:

OA_REQUEST_TIMEOUT_MS=30000

配置示例

{
  "mcpServers": {
    "翼鸥OA流程中心": {
      "timeout": 60,
      "command": "npx",
      "args": ["-y", "eeo-oa-workflow-mcp@latest"],
      "env": {
        "API_KEY": "你的 API Key",
        "OA_BASE_URL": "你的 OA 环境地址"
      }
    }
  }
}

版本与发布记录

eeo-oa-workflow-mcp 共发布 7 个版本,首次发布于 2026/10/21;过去 12 个月发布了 7 个版本。

版本发布日期距今
0.5.0latest2026/11/03今天
0.4.02026/10/268 天前
0.3.02026/10/2113 天前
0.2.12026/10/2113 天前
0.2.02026/10/2113 天前
0.1.02026/10/2113 天前

关于 eeo-oa-workflow-mcp 的常见问题

eeo-oa-workflow-mcp 是什么?

翼鸥 OA 流程中心 MCP 服务

如何安装 eeo-oa-workflow-mcp?

在项目目录运行 npm install eeo-oa-workflow-mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 eeo-oa-workflow-mcp,可以用 npx eeo-oa-workflow-mcp 直接运行。

eeo-oa-workflow-mcp 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/eeo-oa-workflow-mcp 是否存在。

eeo-oa-workflow-mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

eeo-oa-workflow-mcp 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

eeo-oa-workflow-mcp 可以商用吗?

eeo-oa-workflow-mcp 使用 UNLICENSED 许可。作者声明为 UNLICENSED,即不授予公开使用许可(与公共领域的 Unlicense 不同)。使用前需获得作者授权。以上为概括,不构成法律意见,请以许可原文为准。

eeo-oa-workflow-mcp 还在维护吗?

最新版本 0.5.0 发布于 2026/11/03(今天);至今共发布 7 个版本,其中过去 12 个月发布了 7 个;首次发布于 2026/10/21。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。