使用说明
建设成本计算器MCP服务器
一个无身份验证的MCP(模型上下文协议)服务器,使用来自公共谷歌表格的数据提供建筑成本估算工具。
特性
- 不要求进行验证:从可公开访问的谷歌表格中读取
- 5可用工具:
list_all_items-获取所有建筑项目get_item-按代码获取特定项目的详细信息search_items-按关键字搜索项目get_items_by_category-按类别筛选项目calculate_cost-用工程量计算项目总成本
数据源
服务器从谷歌表格中获取建筑成本数据: 工程造价数据库
数据包括:
- 混凝土(板、基脚、墙、柱、楼梯)
- 框架(墙、地板、屋顶、梁)
- 饰面(干墙、油漆、地板、瓷砖)
- 电气(接线、面板、插座、固定装置)
- 管道(管道、固定装置、热水器)
- 暖通空调(系统、管道系统)
- 屋面(材料、安装)
- 外部(墙板、窗户、门)
本地开发
先决条件
- Python 3.11+
- 点
设置
- 克隆存储库:
cd construct_cost_calc
- 创建虚拟环境:
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
- 安装依赖项:
pip install -r requirements.txt
- 运行服务器:
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
一键部署
手动部署
- 将此存储库推送到GitHub
- 首选 渲染仪表板
- 点击 新 → 蓝图
- 连接您的存储库
- 渲染将使用
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
许可证
麻省理工学院
