Metadata-Version: 2.4
Name: erp-integral-mcp
Version: 1.2.0
Summary: 鼎尖 ERP 业务动作积分统计 MCP：积分项查询、按日/按积分项汇总
License: Proprietary
Project-URL: Homepage, https://open.workbuddy.cn/docs/connector
Project-URL: Documentation, https://open.workbuddy.cn/docs/connector
Keywords: mcp,dingjian,erp,integral,settlement,stdio,uvx,workbuddy
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.2.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.0
Requires-Dist: pydantic-settings>=2.0
Requires-Dist: python-dotenv>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.24; extra == "dev"

# erp-integral-mcp

鼎尖 ERP **业务动作积分**统计 MCP：第三方 SHA1 签名鉴权，查询积分项清单，并按**日历日**或**积分项**汇总每位员工的作业积分。

## 接口

| Tool | ERP API | 说明 |
| --- | --- | --- |
| `search_persons` | `basedata/person/dataPickerData` | 姓名/工号 → personId（F7） |
| `list_integral_jobsets` | `settlement/integralDetail/getIntegralConditon` | 积分项（jobSet）清单 |
| `query_integral_stats` | `settlement/integralDetail/integralCountData` | 人员积分；支持 `personId`；`group_by=week` |

`columnType`：

- `INTEGRALDATE`：按日，`scoreN` = 当月第 N 日积分
- `INTEGRALJOBSET`：按积分项，字段名为积分项 `id`，需结合 `jobSetList` 解读

## 环境变量

与 `erp-property-mcp` 相同：

```bash
ERP_BASE_URL=https://your-host/dingjian/
ERP_SECRET=...
ERP_CU_ID=...
ERP_USER_ID=...
ERP_DC=...
```

## 本地运行

```bash
cd mcp/erp-integral-mcp
cp .env.example .env   # 填入凭证
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest
erp-integral-mcp       # stdio MCP
```

## uvx / WorkBuddy

```json
{
  "mcpServers": {
    "erp_integral": {
      "command": "uvx",
      "args": ["erp-integral-mcp@1.0.0"],
      "env": {
        "ERP_BASE_URL": "${ERP_BASE_URL}",
        "ERP_SECRET": "${ERP_SECRET}",
        "ERP_CU_ID": "${ERP_CU_ID}",
        "ERP_USER_ID": "${ERP_USER_ID}",
        "ERP_DC": "${ERP_DC}"
      }
    }
  }
}
```

连接器打包：

```bash
./scripts/pack-connector.sh
```

## Skill

业务作业 SOP 见 `skills/erp-integral-stats/SKILL.md`（仓库同步副本：`mcp/skills/erp-integral-stats/SKILL.md`）。
