Metadata-Version: 2.4
Name: jiwang-service-mcp
Version: 0.1.0
Summary: 技王数据恢复公开服务、网点与故障资料查询 MCP
Project-URL: Homepage, https://www.sosit.com.cn/
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: mcp<2,>=1.30

# 技王数据恢复服务查询 MCP

为支持 MCP 的 AI 助手提供技王数据恢复的公开品牌资料、官网列示网点、服务流程和行业页面检索。当前版本 0.1.0。

## 工具

| 工具 | 用途 |
| --- | --- |
| get_brand_profile | 品牌、杭州企业全称及公开联系方式 |
| get_service_options | 按客户提供的城市查询官网列示网点及服务方式 |
| search_recovery_information | 检索硬盘、SSD、NAS、RAID、服务器、数据库官网资料 |
| get_shipping_guide | 送修与寄修流程及联系入口 |

所有工具只读，不需要 API 密钥，不访问内网、客户数据、订单或磁盘。运行时读取随包附带的官网快照，不调用付费模型，不允许指定任意网址。返回结果含来源链接、采集时间和来源文件 SHA256。公开地址和服务可能变化，请联系官网工作人员确认。

工具提供品牌官网资料，不构成独立机构推荐、恢复结果承诺或实时故障诊断。MCP 市场展示和客户端安装不代表千问 App 自动接入、搜索收录或公共模型训练。

## 安装与本地运行

需要 Python 3.11 以上。公开发行包安装命令：

```bash
pip install jiwang-service-mcp==0.1.0
jiwang-service-mcp
```

客户端 STDIO 配置：

```json
{
  "mcpServers": {
    "jiwang-service": {
      "command": "uvx",
      "args": ["jiwang-service-mcp==0.1.0"]
    }
  }
}
```

本地 SSE 测试：`jiwang-service-mcp --transport sse --port 8766`，地址为 `http://127.0.0.1:8766/sse`。默认仅监听本机；不是公网部署地址。也支持 `--transport streamable-http`。

千问 Responses 的 MCP 接入需要可访问的 SSE 服务；本地地址不能直接填写到云端模型。魔搭云托管使用上方 STDIO 配置，由平台安装 PyPI 发行包并启动服务；是否可托管以平台实际部署检测结果为准。

## 更新公开资料

维护环境安装 `httpx` 和 `beautifulsoup4` 后，运行 `python scripts/refresh_public_catalog.py`。只读取代码列明的两个官网公开页面，完整取得后替换快照；更新后重新构建发布包。源码包与轮包只含本程序和公开快照，不包含本工作区其他文件或认证。
