Metadata-Version: 2.4
Name: dj-website-qa-mcp
Version: 1.2.0
Summary: 鼎尖软件官网客户问答 MCP：查询查重 + 保存 + 静态化
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/listData`
- 保存：`projectm/projectmDataItem/save`
- 静态化：`https://www.dingjiansoft.com/staticHtmlNew?scope=khwd&type=website`

## 安装与运行

### 开发

```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）

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

## MCP Tools

| Tool | 说明 |
|------|------|
| `list_website_qa` | 查询已有问答；支持关键词过滤与标题查重 |
| `save_website_qa` | 保存/更新；新建默认查重；`status=1` 默认自动静态化 |
| `staticize_website_qa` | 手动触发客户问答静态化页面 |

## 鉴权说明

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

| 变量 | 说明 |
|------|------|
| `ERP_BASE_URL` | 如 `https://www.dingjianyun.com/dingjianerp/` |
| `ERP_SECRET` / `ERP_CU_ID` / `ERP_USER_ID` / `ERP_DC` | 第三方签名凭证 |
| `DJ_WEBSITE_PROGRAMA_ITEM_ID` | 客户问答栏目，默认 `fa910000-0000-4000-8000-000000000001` |
| `DJ_WEBSITE_STATICIZE_URL` | 静态化地址（可覆盖） |
| `DJ_WEBSITE_AUTO_STATICIZE` | 发布后是否自动静态化，默认 `true` |

注意：列表侧已发布多为 `status=2`，保存侧发布为 `status=1`，勿混用。

## 测试

```bash
pytest
```
