建筑成本计算器

一个无需身份验证的MCP服务器,提供从公共Google表格获取数据的建筑成本估算工具。

  • by AbhiGit-Trimble
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 AbhiGit-Trimble/construct-cost-mcp

使用说明

建设成本计算器MCP服务器

一个无身份验证的MCP(模型上下文协议)服务器,使用来自公共谷歌表格的数据提供建筑成本估算工具。

特性

  • 不要求进行验证:从可公开访问的谷歌表格中读取
  • 5可用工具:
    • list_all_items -获取所有建筑项目
    • get_item -按代码获取特定项目的详细信息
    • search_items -按关键字搜索项目
    • get_items_by_category -按类别筛选项目
    • calculate_cost -用工程量计算项目总成本

数据源

服务器从谷歌表格中获取建筑成本数据: 工程造价数据库

数据包括:

  • 混凝土(板、基脚、墙、柱、楼梯)
  • 框架(墙、地板、屋顶、梁)
  • 饰面(干墙、油漆、地板、瓷砖)
  • 电气(接线、面板、插座、固定装置)
  • 管道(管道、固定装置、热水器)
  • 暖通空调(系统、管道系统)
  • 屋面(材料、安装)
  • 外部(墙板、窗户、门)

本地开发

先决条件

  • Python 3.11+
  • 点

设置

  1. 克隆存储库:
cd construct_cost_calc
  1. 创建虚拟环境:
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. 安装依赖项:
pip install -r requirements.txt
  1. 运行服务器:
python server.py

服务器将于启动 http://localhost:8000 SSE运输。

环境变量

变量 默认值 描述
GOOGLE_SHEET_ID 1laH5l1FjwWC5HXLp8xkG1eolwScKHIlxB6PohBWQjh0 谷歌表格ID
SHEET_GID 0 “图纸”选项卡GID
CACHE_TTL_SECONDS 300 缓存持续时间(5分钟)
DEFAULT_LABOR_RATE 75.0 默认美元/小时费率

部署到Render.com

一键部署

手动部署

  1. 将此存储库推送到GitHub
  2. 首选 渲染仪表板
  3. 点击 新 → 蓝图
  4. 连接您的存储库
  5. 渲染将使用 render.yaml 配置服务

部署后

您的MCP服务器将在以下网址提供:

https://your-service-name.onrender.com/sse

连接至Agenti AI平台

将MCP服务器添加到Agenti AI配置中:

{
  "mcpServers": {
    "construction-cost": {
      "url": "https://your-service-name.onrender.com/sse"
    }
  }
}

工具使用示例

列出所有项目

Tool: list_all_items
Parameters: none

获取特定项目

Tool: get_item
Parameters: {"item_code": "concrete_slab_4000psi"}

搜索项

Tool: search_items
Parameters: {"query": "drywall"}

按类别获取项目

Tool: get_items_by_category
Parameters: {"category": "concrete"}

计算成本

Tool: calculate_cost
Parameters: {
  "items": [
    {"item_code": "concrete_slab_4000psi", "quantity": 2000},
    {"item_code": "framing_wall_2x4", "quantity": 500},
    {"item_code": "drywall_standard_12", "quantity": 3000}
  ],
  "labor_rate": 80.0
}

成本计算公式

Item Cost = (Material Cost × Quantity) + (Labor Hours × Quantity × Labor Rate)
Total Cost = Sum of all Item Costs

许可证

麻省理工学院