Skip to main content
Glama

泛微 E10 OA MCP 服务

通过 MCP (Model Context Protocol) 连接泛微 E10 OA,查询程序修改流程列表和详情。

快速开始

1. 安装

# Windows
setup.bat

# Linux / macOS
chmod +x setup.sh && ./setup.sh

或手动安装:

pip install -e .

2. 配置

复制 .env.example 为 .env,填入实际配置:

WEAVER_BASE_URL=http://oa.yourcompany.com
WEAVER_CORPID=your_corpid
WEAVER_APP_KEY=your_app_key
WEAVER_APP_SECRET=your_app_secret
WEAVER_USER_ID=your_user_id          # E10 长数字格式
WEAVER_WORKFLOW_ID=your_workflow_id  # 程序修改流程的工作流ID

3. 启动

python -m weaver_mcp

4. 接入 MCP 客户端

在 MCP 客户端配置文件中添加(参考 mcp-config.example.json):

{
  "mcpServers": {
    "weaver-oa": {
      "command": "python",
      "args": ["-m", "weaver_mcp"],
      "cwd": "/path/to/weaver-mcp"
    }
  }
}

也可通过环境变量直接配置,无需 .env 文件。

Related MCP server: ConnectWise API Gateway MCP Server

MCP 工具列表

工具名

功能

说明

test_connection

测试连接

验证 OAuth2 认证和配置是否正确

list_program_modification_workflows

查询程序修改流程列表

支持 date_range 日期筛选

get_workflow_detail

获取流程详情

包含表单数据、审批记录

get_program_modification_details

组合查询

一步完成列表+详情

list_all_workflows

所有流程列表

支持 date_range 日期筛选

list_todo_workflows

待办流程列表

需后台授权

list_my_workflows

我的请求列表

需后台授权

list_processed_workflows

已办流程列表

需后台授权

query_employee

查询人员信息

需后台授权

日期筛选参数

date_range 可选值:

值

含义

TODAY

今天

CURRENT_WEEK

本周

CURRENT_MONTH

本月

CURRENT_SEASON

本季度

CURRENT_YEAR

本年

PRE_MONTH

上一月

PRE_YEAR

上一年

泛微后台配置

获取应用凭证

  1. 登录 E10 后台管理中心

  2. 进入 开放平台 → 开发者资料,获取 corpid

  3. 进入 开放平台 → 应用管理,创建应用,获取 app_key 和 app_secret

授权 API 权限

路径:E10 后台 → 开放平台 → 应用管理 → 应用详情 → API 权限

需要授权的接口:

接口

必需

用途

getAllWorkflowRequestList

是

查询流程列表

getWorkflowRequest

是

获取流程详情

getToDoWorkflowRequestList

否

查询待办列表

getMyWorkflowRequestList

否

查询我的请求

getProcessedWorkflowRequestList

否

查询已办列表

queryEmployee

否

查询人员信息

获取用户 ID

E10 的 userId 是长数字格式(如 1234567890123456789),获取方式:

  • 在 E10 后台 → 人员管理中查看用户详情

  • 或授权 queryEmployee 接口后通过 API 查询

技术架构

weaver-mcp/
├── weaver_mcp/               # Python 包
│   ├── __init__.py
│   ├── __main__.py           # 入口点 (python -m weaver_mcp)
│   ├── config.py             # 配置加载
│   ├── weaver_client.py      # 泛微 API 客户端
│   └── main.py               # MCP 工具定义
├── .env                      # 实际配置(不提交)
├── .env.example              # 配置模板
├── mcp-config.example.json   # MCP 客户端配置示例
├── pyproject.toml            # Python 打包配置
├── requirements.txt          # 依赖清单
├── setup.bat / setup.sh      # 一键安装脚本
└── README.md

API 端点

类型

路径

方法

OAuth2 授权

/openserver/oauth2/authorize

GET

OAuth2 Token

/openserver/oauth2/access_token

POST

流程列表

/papi/openapi/api/workflow/list/paService/v1/getAllWorkflowRequestList

POST

流程详情

/papi/openapi/api/workflow/core/paService/v1/getWorkflowRequest

GET

人员查询

/papi/openapi/api/hrm/restful/queryEmployee

POST

环境要求

  • Python 3.10+

  • 网络可访问泛微 OA 服务器

Available Tools

10 tools
get_program_modification_detailsA

获取程序修改流程列表及其详情(组合查询)

自动完成"查列表 → 拿ID → 获取详情"的完整流程。 先查询程序修改流程列表,再批量获取每个流程的详细信息。

Args: page_no: 页码,从1开始 page_size: 每页条数(默认5,避免请求过多)

Returns: 包含流程列表和每个流程详情的 JSON 字符串

Inputs: page_no, page_size. Returns: result

get_workflow_detailA

获取流程详情

根据流程请求ID获取流程的详细信息,包括表单数据、审批记录等。 这是获取程序修改具体内容的核心接口。

Args: request_id: 流程请求ID(从流程列表返回的 requestid 字段获取) is_get_form_data: 是否获取表单数据,默认true is_get_request_log: 是否获取签字意见,默认true

Returns: 流程详情 JSON 字符串,包含表单字段值、审批意见、流转日志等

Inputs: request_id (required), is_get_form_data, is_get_request_log. Returns: result

list_all_workflowsA

获取所有流程列表(支持按流程类型和日期筛选)

获取当前用户可见的所有流程列表。

Args: page_no: 页码,从1开始 page_size: 每页条数 date_range: 日期筛选,可选值: TODAY(今天), CURRENT_WEEK(本周), CURRENT_MONTH(本月), CURRENT_SEASON(本季度), CURRENT_YEAR(本年), PRE_MONTH(上一月), PRE_YEAR(上一年) 留空则不筛选日期 workflow_id: 工作流模板ID,留空则使用默认配置的程序修改流程ID。 已知流程类型ID: - 程序修改审批: 1228999200920870994 - 研发报工: 1230367835375575122 - 研发日志: 1222687239679377410 - 出差申请流程: 1105613930453606403 - 报销申请: 1117917637315977296 - 备件业务审批: 1296790062983503878 - 合同类项目立项: 1295604918247448577 all_types: 为 True 时返回所有流程类型(不按 workflowid 过滤)

Returns: 所有流程列表 JSON 字符串

Inputs: page_no, all_types, page_size, date_range, +1 more. Returns: result

list_my_workflowsA

获取我的请求流程列表

获取当前用户发起的流程列表。

Args: page_no: 页码,从1开始 page_size: 每页条数 workflow_id: 工作流模板ID,留空则使用默认配置 all_types: 为 True 时返回所有流程类型

Returns: 我的请求流程列表 JSON 字符串

Inputs: page_no, all_types, page_size, workflow_id. Returns: result

list_processed_workflowsB

获取已办(归档)流程列表

获取当前用户已处理的流程列表。

Args: page_no: 页码,从1开始 page_size: 每页条数 workflow_id: 工作流模板ID,留空则使用默认配置 all_types: 为 True 时返回所有流程类型

Returns: 已办流程列表 JSON 字符串

Inputs: page_no, all_types, page_size, workflow_id. Returns: result

list_program_modification_workflowsA

查询程序修改流程列表

使用配置的 workflowid 查询该工作流类型的所有流程实例。 返回流程列表,每个流程包含 requestId(用于获取详情)、标题、状态、创建人等。

Args: page_no: 页码,从1开始,默认1 page_size: 每页条数,默认20 date_range: 日期筛选,可选值: TODAY(今天), CURRENT_WEEK(本周), CURRENT_MONTH(本月), CURRENT_SEASON(本季度), CURRENT_YEAR(本年), PRE_MONTH(上一月), PRE_YEAR(上一年) 留空则不筛选日期

Returns: 流程列表 JSON 字符串,包含 requestId 列表

Inputs: page_no, page_size, date_range. Returns: result

list_todo_workflowsA

获取待办流程列表

获取当前用户待处理的流程列表。

Args: page_no: 页码,从1开始 page_size: 每页条数 workflow_id: 工作流模板ID,留空则使用默认配置 all_types: 为 True 时返回所有流程类型的待办(不按 workflowid 过滤)

Returns: 待办流程列表 JSON 字符串

Inputs: page_no, all_types, page_size, workflow_id. Returns: result

query_employeeA

查询泛微 E10 人员信息

通过姓名模糊查询或账号精确查询人员,返回人员ID(userId)等信息。 userId 用于流程列表和流程详情查询。

Args: name_like: 人员姓名(支持模糊查询),如"张三" account: 账号(登录名/手机/邮箱) page_size: 页大小,默认50

Returns: 人员信息 JSON 字符串,包含 id(userId)、username、job_num 等

Inputs: account, name_like, page_size. Returns: result

submit_work_reportA

提交研发报工流程

创建并提交一条研发报工,表单字段自动填充(研发项目、部门、人员等)。 工作内容根据月份自动选择,也可手动指定。

Args: report_date: 报工日期,格式 YYYY-MM-DD(如 2026-08-14) work_content: 工作内容简述,留空则根据月份自动选择: 1-4月:启动知识库构建,开发知识库问答前端界面... 5-8月:工艺参数预警:基于历史数据建立波动预警模型... 9-12月:AI闭环控制,连续制造物料追踪 project_hours: 项目工时,默认8

Returns: 创建结果 JSON 字符串,包含 requestId

Inputs: report_date (required), work_content, project_hours. Returns: result

test_connectionA

测试与泛微 OA 的连接是否正常

尝试获取 access_token 并返回服务器信息,用于验证配置是否正确。

Inputs: no named parameters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 10 tools

    Disambiguation4/5

    Most tools have clear, distinct purposes, especially the status-specific workflow lists (todo, my, processed, all) and the composite detail fetcher. Some overlap exists between list_program_modification_workflows and list_all_workflows with the default workflow id, but descriptions are detailed enough to guide selection.

    Naming Consistency5/5

    Tool names consistently follow a verb_noun snake_case pattern, such as list_*, get_*, query_*, and submit_*. Minor asymmetry like get_workflow_detail versus list_*_workflows is negligible and does not hurt predictability.

    Tool Count5/5

    Ten tools is a reasonable, well-scoped surface for an OA workflow integration. Each tool covers a distinct need: connection testing, employee lookup, workflow listing by status, workflow details, and report submission.

    Completeness3/5

    Read-oriented workflow coverage is solid with list, detail, and status-specific queries, plus one submission workflow. However, there are notable gaps: no approve/reject actions for todo workflows, no generic process submission, and no update/cancel operations for existing workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers