Metadata-Version: 2.4
Name: dj-website-qa-mcp
Version: 1.0.0
Summary: 鼎尖软件官网客户问答 MCP：第三方签名鉴权保存 FAQ/问答内容
License: Proprietary
Project-URL: Homepage, https://open.workbuddy.cn/docs/connector
Project-URL: Documentation, https://open.workbuddy.cn/docs/connector
Keywords: mcp,dingjian,website,faq,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"

# 鼎尖软件官网客户问答 MCP（Python / uvx）

鼎尖 ERP **第三方签名鉴权**，调用 `projectm/projectmDataItem/save` 保存官网「客户问答」。

## 安装与运行

### 开发

```bash
cd mcp/dj-website-qa/dj-website-qa-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
cp -n .env.example .env
# 编辑 .env 填入 ERP_*
python -m dj_website_qa_mcp
```

### 用户侧（推荐 uvx）

先发布到 PyPI，再：

```bash
uvx dj-website-qa-mcp
```

## MCP Tools

| Tool | 说明 |
|------|------|
| `save_website_qa` | 保存/更新官网客户问答（title + content 必填） |

## 鉴权说明

与 `erp-property-mcp` 相同，**无需 Bearer Token**：

| 变量 | 对应第三方参数 | 说明 |
|------|----------------|------|
| `ERP_BASE_URL` | - | 如 `https://www.dingjianyun.com/dingjianerp/` |
| `ERP_SECRET` | secret | 第三方 secret |
| `ERP_CU_ID` | thirdCuId | 控制单元 |
| `ERP_USER_ID` | thirdUserId | 用户 |
| `ERP_DC` | thirdDc | 数据中心 |
| `DJ_WEBSITE_PROGRAMA_ITEM_ID` | programaItem.id | 客户问答栏目，默认 `fa910000-0000-4000-8000-000000000001` |

签名步骤：

1. 将 `secret, thirdtimestamp, thirdCuId, thirdUserId, thirdDc, apiPath` **字典序排序**后拼接
2. 做 **SHA1 hex**，写入请求头 `djthirdsign`
3. `apiPath` = `projectm/projectmDataItem/save`（不含 host 与 query）
4. URL 仅带 `?djrqformat=pcjson`

## 测试

```bash
pytest
```
