建筑：建筑报建全流程监控

建筑：建筑报建全流程监控

该 MCP 服务围绕建筑报建全流程监控，提供建筑项目检索、项目详情、招投标、合同、施工图审查、施工许可和竣工信息查询能力。

所属板块：运营资产

主要功能

• 建筑报建项目多条件检索
• 项目基本信息与参建主体
• 项目招投标与合同进展
• 施工图审查合格书信息
• 施工许可与竣工信息

服务设计说明

• 服务覆盖项目发现、招投标、合同、施工图审查、施工许可和竣工等关键报建阶段；“监控”由调用方按需查询实现，不包含后台订阅或主动推送。
• 服务提供 7 个只读 Tool，单次 Tool 调用只访问一个 Product ID。
• 翻页结果统一收口为 total 与 resultList。
• 成功响应自动兼容 Gateway业务 data和内部 stat/data 两种形态。
• 请求超时可通过 HANDAAS_REQUEST_TIMEOUT 配置，默认30秒。

环境要求

• Python 3.10+
• 依赖：mcp、python-dotenv、requests

本地快速启动

cd construction-mcp-server
python3 -m venv mcp_env
source mcp_env/bin/activate
pip install -r requirements.txt
cp .env.example .env
python server/mcp_server.py streamable-http

服务默认地址：http://127.0.0.1:8000/mcp。支持 stdio、sse 和 streamable-http。

环境变量

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key
HANDAAS_REQUEST_TIMEOUT=30

真实凭据只能保存在本地 .env 或部署密钥中。

Cursor / Cherry Studio配置

{
  "mcpServers": {
    "construction-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

可用 Tool 与 Product ID

推荐调用流程

1. 调用 construction_project_search 通过项目名称、地区或建设属性定位项目。
2. 从结果中确认项目名称并取得 _id，该值在 MCP 参数中称为 sikuId。
3. 使用 sikuId 查询项目详情、合同、施工图审查、施工许可和竣工信息。
4. 招投标 Tool 使用项目名称，不使用 sikuId。

Tool 详细说明

1. construction_project_search

何时使用：用户只提供项目名称、地区、建设单位、中标单位或工程特征时，用于定位项目和取得后续查询 ID。

关键参数：projectNameInclude 为项目名称包含词，projectNameExclude 为排除词；biddingWinner 可按中标单位筛选；面积和长度区间下限不能大于上限；pageIndex 从 1 开始，pageSize 最大 50。

返回说明：返回项目摘要、项目名称和 _id。详情类 Tool 使用 _id 作为 sikuId。

2. construction_project_detail

何时使用：需要核对项目基本信息、建设单位和参建主体时使用。

关键参数：sikuId 必须来自项目检索结果。

返回说明：命中时返回一条项目综合详情，顶层为 total/resultList。

3. construction_project_bidding_list

何时使用：需要查看项目招标公告、采购信息、中标单位或中标信息时使用。

关键参数：projectName 建议使用项目检索返回的完整名称；支持分页。

返回说明：返回与该名称全文匹配的招投标记录。

4. construction_project_contract_list

何时使用：需要查看合同金额、发包单位、承包单位和合同状态时使用。

关键参数：sikuId 来自项目检索；支持分页。

返回说明：返回项目关联合同列表。

5. construction_project_drawing_review_list

何时使用：需要核实施工图审查合格书编号及其关联工程时使用。

关键参数：sikuId 来自项目检索；支持分页。

返回说明：该 Tool 从施工许可数据中投影 censorNum、工程名称、施工许可证号和发证时间，只返回存在审查合格书编号的记录。

6. construction_project_permit_list

何时使用：需要查看施工许可证、许可工程和关联单位人员时使用。

关键参数：sikuId 来自项目检索；支持分页。

返回说明：返回施工许可明细列表。

7. construction_project_completion_list

何时使用：需要确认项目竣工备案或竣工验收进度时使用。

关键参数：sikuId 来自项目检索；支持分页。

返回说明：合并备案和验收记录；recordType=completion_record 表示竣工备案，recordType=completion_acceptance 表示竣工验收。

使用示例

示例一：定位项目

搜索广东省名称包含“产业园”的建筑项目，先返回 5 个。

{
  "tool": "construction_project_search",
  "arguments": {
    "projectNameInclude": "产业园",
    "region": "广东省",
    "pageIndex": 1,
    "pageSize": 5
  }
}

示例二：查看项目全流程

查看刚才项目的参建主体、合同、施工许可和竣工信息。

先使用搜索结果的 _id 调用 construction_project_detail，再用同一 sikuId 分别调用合同、许可和竣工 Tool。

示例三：查看招投标

查询这个产业园项目相关的招标和中标信息。

{
  "tool": "construction_project_bidding_list",
  "arguments": {
    "projectName": "从项目搜索结果取得的完整项目名称",
    "pageIndex": 1,
    "pageSize": 20
  }
}

使用注意事项

1. 项目详情、合同、许可和竣工查询使用项目检索返回的 _id 作为 sikuId。
2. 招投标查询使用项目名称进行全文匹配，名称过短可能产生较多候选。
3. 施工图审查 Tool 不是独立上游接口，只投影施工许可明细中已有的审查合格书字段。
4. “监控”由调用方按需重复查询实现，本服务不提供后台订阅或主动推送。

测试验证

python -m py_compile server/mcp_server.py
python -m unittest discover -s tests -v

单元测试使用 Mock 响应；真实验证通过本地 .env 调用 HandaaS Integrator Gateway。