weaver-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@weaver-mcp 查询本月的程序修改流程列表"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
泛微 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 # 程序修改流程的工作流ID3. 启动
python -m weaver_mcp4. 接入 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 工具列表
工具名 | 功能 | 说明 |
| 测试连接 | 验证 OAuth2 认证和配置是否正确 |
| 查询程序修改流程列表 | 支持 |
| 获取流程详情 | 包含表单数据、审批记录 |
| 组合查询 | 一步完成列表+详情 |
| 所有流程列表 | 支持 |
| 待办流程列表 | 需后台授权 |
| 我的请求列表 | 需后台授权 |
| 已办流程列表 | 需后台授权 |
| 查询人员信息 | 需后台授权 |
日期筛选参数
date_range 可选值:
值 | 含义 |
| 今天 |
| 本周 |
| 本月 |
| 本季度 |
| 本年 |
| 上一月 |
| 上一年 |
泛微后台配置
获取应用凭证
登录 E10 后台管理中心
进入 开放平台 → 开发者资料,获取
corpid进入 开放平台 → 应用管理,创建应用,获取
app_key和app_secret
授权 API 权限
路径:E10 后台 → 开放平台 → 应用管理 → 应用详情 → API 权限
需要授权的接口:
接口 | 必需 | 用途 |
| 是 | 查询流程列表 |
| 是 | 获取流程详情 |
| 否 | 查询待办列表 |
| 否 | 查询我的请求 |
| 否 | 查询已办列表 |
| 否 | 查询人员信息 |
获取用户 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.mdAPI 端点
类型 | 路径 | 方法 |
OAuth2 授权 |
| GET |
OAuth2 Token |
| POST |
流程列表 |
| POST |
流程详情 |
| GET |
人员查询 |
| POST |
环境要求
Python 3.10+
网络可访问泛微 OA 服务器
Available Tools
10 toolsget_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
Scored across 10 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for Arcoro and ExakTime — workforce data, jobs, cost codes and locations.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
MCP server providing attendance data queries via the CloudTime API.
MCP server for managing FormDesigner forms, fields, logic rules, themes, and entries
Related MCP Servers
- AlicenseAqualityBmaintenanceAn MCP (Model Context Protocol) server that enables integration with the Simplifier Low Code Platform. This server provides tools and capabilities for creating and managing Simplifier Connectors and BusinessObjects through the platform's REST API.1759 npm5MIT
- FlicenseNot gradedqualityDmaintenanceThis MCP server simplifies interaction with the ConnectWise Manage API through API discovery, execution, and a fast memory system for efficient workflows.-
- AlicenseAqualityDmaintenanceMCP server for Mybatis-Flex ORM framework providing API documentation, code examples, and changelog queries.415 npm1MIT
- AlicenseNot gradedqualityCmaintenanceThis MCP server provides tools to interact with the AgileWorks business process platform via its Web API, enabling document management, workflow operations, user administration, and more.1MIT