# eeo-oa-workflow-mcp 中文文档

规范地址：https://npmcn.com/package/eeo-oa-workflow-mcp/

版本：0\.5\.0
npm 元数据更新时间：2026-11-03T13:15:16.523Z
中文译文更新时间：2026-11-03T13:45:28.135Z
软件包许可：UNLICENSED

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/eeo-oa-workflow-mcp
原文对照：https://npmcn.com/package/eeo-oa-workflow-mcp/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：62.9 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：2 个
- 首次发布：2026-10-21T06:18:51.496Z
- 最新版本发布：2026-11-03T13:15:16.297Z
- 已发布版本数：7（近 12 个月 7 个）

## 中文简介

翼鸥 OA 流程中心 MCP 服务

## 安装

```sh
npm install eeo-oa-workflow-mcp
```

也可以使用：`pnpm add eeo-oa-workflow-mcp`、`yarn add eeo-oa-workflow-mcp`、`bun add eeo-oa-workflow-mcp`

## README

# 翼鸥 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 的个人信息自动补齐。该工具会直接发起流程，不保存草稿。

## 环境变量

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

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

可选：

```text
OA_REQUEST_TIMEOUT_MS=30000
```

## 配置示例

```json
{
  "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 是什么？

翼鸥 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 和提交记录判断。