审查结果统计工具 MCP 服务

📖 简介

审查结果统计工具是一个专业的MCP（Model Context Protocol）服务，用于分析施工图智能审查结果文件（.aicdump格式），自动提取审查数据并进行多维度统计分析，生成详细的审查统计报告。

✨ 主要功能

🔍 智能数据提取

• 自动从.aicdump压缩文件中提取审查数据
• 支持多种文件路径格式
• 支持base64编码文件传输
• 智能解析JSON数据结构

📊 多维度统计分析

总体统计

• 总条文数量
• 总检查项数量
• 总组件检查数量
• 通过/不通过数量及百分比

分类组统计

• 按消防、无障碍、通用等分类进行统计
• 每个分类组的详细统计信息
• 分类组内的标准统计

标准统计

• 按建筑规范标准进行详细统计
• 每个标准的检查项详情
• 检查项的通过/不通过统计

🎯 专业分类体系

内置建筑规范分类规则，支持以下分类：

• 消防：防火门、前室、疏散门、外墙防火间距等
• 无障碍：无障碍通道相关审查
• 通用：楼梯相关审查
• 公建专项：公建专项审查

🚀 快速开始

1. 配置服务

在魔塔社区配置MCP服务，使用提供的配置文件：

• modelscope_config.json - 完整配置
• modelscope_config_simple.json - 简化配置

2. 调用工具

使用analyze_aicdump工具分析文件：

{
  "tool_name": "analyze_aicdump",
  "arguments": {
    "file_path": "/path/to/file.aicdump"
  }
}

3. 获取结果

工具返回详细的统计结果JSON，包含：

• 总体统计信息
• 分类组统计数据
• 标准统计数据
• 检查项详细信息

📋 工具说明

analyze_aicdump

分析.aicdump文件并返回审查统计结果JSON。

参数：

• file_path (string, 必填): .aicdump文件的路径

返回：

{
  "total_issues": 5,
  "total_cases": 12,
  "total_components": 150,
  "total_pass": 120,
  "total_fail": 30,
  "groups": {
    "消防_防火门-相关区域应采用甲级防火门": {
      "index": "1-2",
      "label": "SG_002",
      "type": "消防",
      "group": "防火门-相关区域应采用甲级防火门",
      "total_issues": 2,
      "total_cases": 5,
      "total_components": 45,
      "total_pass": 38,
      "total_fail": 7,
      "standards": {...}
    }
  },
  "standards": {
    "GB 50016-2014（2018年版）_6.1.5": {
      "standard_name": "《建筑设计防火规范》",
      "standard_id": "GB 50016-2014（2018年版）",
      "standard_entry": "6.1.5",
      "total_cases": 2,
      "total_pass": 15,
      "total_fail": 3,
      "cases": {...}
    }
  }
}

🏗️ 支持的标准

• GB 50016-2014（2018年版）《建筑设计防火规范》
• GB 55037-2022《建筑防火通用规范》
• GB 55019-2021《建筑与市政工程无障碍通用规范》
• GB 55031-2022《民用建筑通用规范》

📁 文件格式要求

输入文件格式

.aicdump文件应包含以下结构：

AICHECK_TMP/
  └── model.standard_result.json

JSON数据结构

{
  "issueList": [
    {
      "standardId": "标准编号",
      "standardEntry": "条目编号",
      "standardName": "标准名称",
      "standardType": "标准类型",
      "issueCases": [
        {
          "description": "检查项描述",
          "components": [
            {
              "componentName": "组件名称",
              "storeyName": "楼层名称",
              "result": "Pass" 或 "Fail",
              "description": "组件描述"
            }
          ]
        }
      ]
    }
  ]
}

🔧 API接口

健康检查

GET /mcp/health

列出工具

GET /mcp/tools

调用工具

POST /mcp/tools/analyze_aicdump
Content-Type: application/json

{
  "arguments": {
    "file_path": "/path/to/file.aicdump"
  }
}

SSE流式响应

POST /mcp/sse
Content-Type: application/json
Accept: text/event-stream

{
  "action": "call_tool",
  "tool_name": "analyze_aicdump",
  "arguments": {
    "file_path": "/path/to/file.aicdump"
  }
}

📊 使用示例

示例1：基本使用

import requests

# 调用工具
response = requests.post(
    'https://your-domain.com/mcp/tools/analyze_aicdump',
    json={
        'arguments': {
            'file_path': '/path/to/file.aicdump'
        }
    }
)

result = response.json()
print(result['content'][0]['text'])

示例2：SSE流式响应

import requests
import json

response = requests.post(
    'https://your-domain.com/mcp/sse',
    json={
        'action': 'call_tool',
        'tool_name': 'analyze_aicdump',
        'arguments': {
            'file_path': '/path/to/file.aicdump'
        }
    },
    stream=True,
    headers={'Accept': 'text/event-stream'}
)

for line in response.iter_lines():
    if line:
        data = json.loads(line.decode('utf-8').replace('data: ', ''))
        print(data)

⚙️ 配置说明

SSE参数配置

需要在魔塔社区配置以下请求头参数：

1. Content-Type: application/json（必填）
2. Accept: text/event-stream（必填）

详细配置说明请参考 SSE参数配置说明.md

📈 统计结果说明

总体统计

• total_issues: 总条文数量
• total_cases: 总检查项数量
• total_components: 总组件检查数量
• total_pass: 总通过数量
• total_fail: 总不通过数量

分类组统计

每个分类组包含：

• 分类信息（index, label, type, group）
• 统计数量（total_issues, total_cases, total_components）
• 通过/不通过数量（total_pass, total_fail）
• 该分类组下的标准统计

标准统计

每个标准包含：

• 标准信息（standard_name, standard_id, standard_entry）
• 统计数量（total_cases, total_components）
• 通过/不通过数量（total_pass, total_fail）
• 检查项详情（cases）

🔒 安全与限制

• 文件大小限制：最大100MB
• 超时设置：默认300秒
• 文件格式：仅支持.aicdump格式
• 认证：当前版本不要求认证（生产环境建议添加）

📝 注意事项

1. 确保.aicdump文件包含正确的JSON结构
2. 文件路径可以是本地路径或通过上传接口获得的文件ID
3. 大型文件处理可能需要较长时间
4. 建议在生产环境中配置HTTPS和认证机制

🐛 错误处理

服务会返回详细的错误信息：

• 文件不存在
• 文件格式错误
• JSON解析错误
• 其他处理错误

📚 相关文档

• modelscope_config.json - 完整服务配置
• SSE参数配置说明.md - SSE参数配置指南
• 魔塔社区配置表单.md - 快速配置参考
• README_MCP.md - MCP服务器详细说明

🤝 贡献

欢迎提交Issue和Pull Request！

📄 许可证

MIT License

👥 作者 bkdouniao

审查结果统计工具开发团队

---

版本: 1.0.0
最后更新: 2025年