🔍 vendor-assessment-qcc

企查查MCP供应商评估Skill - 为中国供应商提供9维度深度风险评估

⚠️ 重要说明：本项目基于 Panaversity Supply Chain Plugin 增强开发

在保留原作者所有代码的基础上，增加了企查查MCP集成、9维度评估模型和供应链特有功能。

📋 目录

• 功能概述
• 快速开始
• 安装指南
• 使用方法
• 9维度评估模型
• 18类风险清单
• Kraljic矩阵分类
• 项目结构
• 贡献与反馈
• 致谢
• 许可证

功能概述

解决什么问题？

传统供应商评估对中国企业存在数据盲区：

• ❌ Companies House 无中国数据
• ❌ Creditsafe 无中国覆盖
• ❌ 手动查询耗时2-3天
• ❌ 非上市公司财务不可见

我们的方案

集成 企查查MCP，为中国供应商提供：

• ✅ 实体锚定 - 统一社会信用代码验证
• ✅ 18类风险 - 司法/经营/税务/破产全覆盖
• ✅ 9维度评估 - 基础6维 + 供应链特有3维
• ✅ 实时数据 - 官方数据源直连
• ✅ 3秒评估 - 自动化风险扫描

快速开始

1分钟快速体验（一键安装）

# 1. 一键安装（自动配置 MCP）
bash <(curl -sL https://raw.githubusercontent.com/duhu2000/vendor-assessment-qcc/main/install_qcc_mcp.sh)

# 2. 配置API Key（从 https://agent.qcc.com 申请）
export QCC_MCP_API_KEY="your_api_key_here"

# 3. ⚠️ 重要：重启 Claude Code 以加载 MCP 配置
# 完全退出 Claude Code，然后重新启动

# 4. 验证 MCP 配置（重启后）
# 你应该能看到可用的 MCP 工具：qcc-company, qcc-risk, qcc-ipr, qcc-operation

# 5. 开始评估
/vendor-assessment-qcc 华为技术有限公司

手动安装

# 1. 克隆仓库
git clone https://github.com/duhu2000/vendor-assessment-qcc.git

# 2. 进入目录
cd vendor-assessment-qcc

# 3. 运行安装脚本
bash install_qcc_mcp.sh

# 4. 配置API Key
export QCC_MCP_API_KEY="your_api_key_here"

# 5. ⚠️ 重启 Claude Code（关键步骤）
# 完全退出后重新启动

# 6. 开始评估
/vendor-assessment-qcc 华为技术有限公司

安装指南

系统要求

• 操作系统: macOS / Linux / Windows (WSL)
• Claude Code: 最新版本
• 网络: 可访问 https://agent.qcc.com

安装步骤

步骤1: 申请企查查MCP Key

1. 访问 企查查MCP官网
2. 注册企业账号
3. 申请MCP服务授权
4. 获取API Key

步骤2: 配置环境变量

临时配置（当前终端）:

export QCC_MCP_API_KEY="your_api_key_here"

永久配置（推荐）- 添加到 ~/.zshrc 或 ~/.bashrc:

export QCC_MCP_API_KEY="your_api_key_here"

步骤3: 安装Skill

# 创建Skill目录
mkdir -p ~/.claude/skills/vendor-assessment-qcc

# 复制增强版Skill（推荐）
cp SKILL.qcc-enhanced.md ~/.claude/skills/vendor-assessment-qcc/SKILL.md

# 或复制标准版Skill
cp SKILL.original.md ~/.claude/skills/vendor-assessment-qcc/SKILL.md

使用方法

在Claude Code中使用

供应商评估

# 基础评估
/vendor-assessment-qcc 供应商名称

# 示例
/vendor-assessment-qcc 华为技术有限公司
/vendor-assessment-qcc 阿里巴巴集团
/vendor-assessment-qcc 广州宇辰鞋业科技有限公司

在Python代码中使用

from qcc_mcp_integration.qcc_mcp_connector import QccMcpConnector

# 初始化连接器
connector = QccMcpConnector()

# 完整评估（9维度）
profile = connector.assess_vendor_risk("供应商名称")

# 查看评估结果
print(f"整体风险: {profile.overall_risk}")
print(f"产能资质风险: {profile.capacity_risk}")      # 供应链特有
print(f"组织稳定性风险: {profile.stability_risk}")   # 供应链特有
print(f"业务健康度风险: {profile.business_health_risk}")  # 供应链特有

# 单独评估供应链特有维度
capacity = connector.assess_capacity_and_qualification("供应商名称")
stability = connector.assess_organizational_stability("供应商名称")
health = connector.assess_business_health("供应商名称")

9维度评估模型

基础6维度（Panaversity原版）

供应链特有3维度 ⭐（QCC MCP增强）

18类风险清单

🔴 CRITICAL（立即供应中断）

🔴 HIGH（供应不稳定）

🟡 MEDIUM（财务/合规风险）

• 股权出质、欠税、税务异常、终本案件、动产抵押

🔵 LOW（一般合规风险）

• 一般行政处罚

Kraljic矩阵分类

评估前首先对供应商进行分类：

⚠️ 重要规则：低采购额但唯一来源的供应商必须分类为 Bottleneck（瓶颈型），无论金额大小。

项目结构

vendor-assessment-qcc/
├── README.md                           # 本文件
├── LICENSE                             # Apache 2.0 许可证
├── install_qcc_mcp.sh                  # 一键安装脚本 ⭐
│
├── SKILL.md                            # 当前使用的Skill文件
├── SKILL.original.md                   # 原作者Panaversity版本（6维度）
├── SKILL.qcc-enhanced.md               # QCC MCP增强版（9维度）⭐推荐
│
├── qcc-mcp-integration/                # QCC MCP连接器代码
│   └── qcc_mcp_connector.py            # 核心连接器
│
├── evals/                              # 评估配置
│   └── eval_vendor_assessment.md
│
└── trigger_eval_set.json               # 触发评估集配置

文件说明

贡献与反馈

提交Issue

• Bug反馈
• 功能建议
• 文档改进

提交PR

1. Fork本仓库
2. 创建feature分支 (git checkout -b feature/amazing-feature)
3. 提交修改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 创建Pull Request

联系方式

• 企查查MCP官网: https://agent.qcc.com
• Email: duhu@qcc.com

致谢

• 原版作者 Panaversity 的优秀供应商评估框架
• 企查查MCP - Agent-Native企业数据基座
• Anthropic 的 Claude Code

许可证

Apache License 2.0

基于 Panaversity/agentfactory-business-plugins 构建

让中国供应商评估从"数据盲区"走向"全面透视" 🔍

如果这个项目对您有帮助，请 ⭐ Star 支持！

提交Issue · 贡献代码