AI导哈

建筑行业数据服务

TradesMCP是一个为建筑行业提供实时承包商许可证、建筑许可、材料价格、工资率和合规数据的MCP服务器，适用于AI助手。

  • by Mahender22
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Mahender22/trades-mcp

使用说明

交易MCP

第一个用于建筑行业的MCP服务器。 承包商许可证、建筑许可证、材料定价、人工费率和合规性——所有这些都可以由人工智能助理访问。

将Claude、GPT、Cursor或任何与MCP兼容的AI连接到实时交易数据。不再“亲自去查看网站”

在行动中看到它

许可证验证——ChatGPT说“无效”，TradesMCP做对了

“检查加利福尼亚州承包商许可证1098765是否有效”

左： 没有MCP的Claude Code无法解析CSLB网站，告诉你手动查找。 中心： ChatGPT——自信地说许可证 不存在 并且是 “可能无效” （完全错误）。 正确的 Claude Code+TradesMCP——一个工具调用，正确答案和完整细节。

关于承包商许可证的错误答案可能会造成真正的伤害。信任ChatGPT回应的房主会拒绝合法的承包商。

许可证搜索——竞争对手放弃，TradesMCP交付

“洛杉矶枫树大道1234号被吊销了哪些许可证，他们的检查状态如何？”

左： “你自己去查一下LADBS。” 中心： “我找不到任何东西，地址可能错了。” 正确的 完整的许可证记录——类型、描述、承包商、估价和检查历史，包括日期和通过/失败状态。

劳动力价格——一个权威答案与10个相互矛盾的数字

“在旧金山，电工每小时挣多少钱？”

左： 网络抓取ZipRecruiter，从招聘信息中给出35-55美元/小时的范围。 中心： 来自Indeed/Payscale/Glassdoor的文本墙，有6个不同的矛盾范围。 正确的 一张桌子-- 42.93美元/小时，89306美元/年，来源：美国劳工统计局（2025年）。

合规性——干净的表格与文字墙

“纽约承包商的保证金要求是什么？”

左： 5个司法管辖区的文本墙，价格从2000美元到25000美元不等。 中心： 表情符号汤，多个滚动部分，一篇研究论文。 正确的 一张桌子。四种债券类型。确切金额。三个要点。

为什么选择TradesMCP？

没有TradesMCP 有TradesMCP
核实承包商许可证 AI表示 “访问cslb.ca.gov” 或 给出错误答案 即时查找完整详细信息
搜索建筑许可证 AI表示 “我无法访问它” 许可证记录+检查历史
在旧金山获取电工工资 基于陈旧培训数据的人工智能猜测 42.93美元/小时——BLS 2025数据
纽约的债券要求 人工智能给出了一堵模糊的文字墙 一张干净的桌子，精确的数量

快速开始

安装

# Create and activate a virtual environment
python -m venv trades-mcp-env

# Windows
trades-mcp-env\Scripts\activate

# Mac/Linux
source trades-mcp-env/bin/activate

# Install
pip install trades-mcp

或者从GitHub安装：

pip install git+https://github.com/Mahender22/trades-mcp.git

跑

使用演示模式，在没有任何API密钥的情况下尝试：

# Mac/Linux
export TRADES_MCP_DEMO=true

# Windows
set TRADES_MCP_DEMO=true

然后启动服务器：

trades-mcp

连接到克劳德桌面

添加到您的 claude_desktop_config.json:

视窗 (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "trades-mcp": {
      "command": "C:/path/to/trades-mcp-env/Scripts/trades-mcp.exe",
      "env": {
        "TRADES_MCP_DEMO": "true"
      }
    }
  }
}

Mac/Linux (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "trades-mcp": {
      "command": "/path/to/trades-mcp-env/bin/trades-mcp",
      "env": {
        "TRADES_MCP_DEMO": "true"
      }
    }
  }
}

注： 使用完整路径 trades-mcp 在您的虚拟环境中。移除 TRADES_MCP_DEMO 并为实时数据添加您的API密钥。

连接到克劳德代码

# Add globally (available in every session)
claude mcp add trades-mcp -- trades-mcp

# With demo mode
claude mcp add trades-mcp -e TRADES_MCP_DEMO=true -- trades-mcp

连接到Cursor/Windsurf

TradesMCP适用于任何兼容MCP的客户端。添加 trades-mcp 命令到AI工具的MCP服务器配置。

配置

变量 必填 描述
TRADES_MCP_DEMO 可选 设置 true 用于演示模式（不需要API密钥）
TRADES_MCP_TIER 可选 starter 或 pro （默认值： pro)
BLS_API_KEY 可选 BLS API键，用于劳动力数据的更高费率限制
OLLAMA_URL 可选 用于解析非结构化状态数据的Ollama URL

全部13个工具

第1级——执照和许可证（初学者）

工具 它做什么
verify_contractor_license 按州+许可证号（CA、TX、FL、NY）检查许可证状态
search_contractor_by_name 按名称查找承包商及其许可证信息
check_license_expiration 获取到期日期和续订要求
search_building_permits 按地址、承包商、日期或类型搜索许可证
get_permit_details 完整的许可证记录，包括检查和估价
list_supported_states 有许可证委员会信息的受支持州

第2层——定价和费率（专业版）

工具 它做什么
get_material_prices 20多种材料（木材、铜、PVC等）的当前定价
get_labor_rates 劳工统计局12个大都市区12个行业的劳动力费率
estimate_project_cost 基于项目描述的人工智能粗略估计
compare_regional_costs 使用成本指数比较大都市地区的成本

第3级——合规性（专业）

工具 它做什么
check_insurance_requirements 各州工人赔偿、责任和保险
get_bond_requirements 投标保证金、履约保证金和许可证保证金要求
track_compliance_deadlines 承包商即将到期和续约日期

覆盖

州（全部直播）

  • 加利福尼亚 （CSLB）-实时抓取，跟踪2026条规则更改
  • 得克萨斯 （TDLR）-Socrata REST API，958K+记录
  • 佛罗里达 （DBPR）--使用会话管理进行实时抓取
  • 纽约 （纽约开放数据+DOB BIS）-直播API+抓取

这4个州覆盖了美国承包商许可证需求的65%左右。

贸易（人工费率）

电工、水管工、暖通空调、木匠、油漆工、屋顶工、石匠、焊工、总承包商、钣金、保温、混凝土

都会区（区域定价）

旧金山、纽约、洛杉矶、波士顿、西雅图、芝加哥、丹佛、迈阿密、达拉斯、休斯顿、凤凰城、亚特兰大

运作原理

┌──────────────┐     MCP      ┌──────────────┐      API      ┌──────────────┐
│              │  ──────────►  │              │  ──────────►  │              │
│  Claude /    │   Tool calls  │  TradesMCP   │   HTTP        │ CSLB / BLS / │
│  GPT /       │  ◄──────────  │   Server     │  ◄──────────  │ Socrata /    │
│  Cursor      │   Results     │  (your PC)   │   JSON        │ Open Data    │
└──────────────┘               └──────────────┘               └──────────────┘

您的数据保留在您的机器上。TradesMCP在本地运行，并直接连接到公共API和许可委员会。

数据来源和新鲜度

数据 来源 如何获取 更新频率
CA许可证 CSLB网站 实时抓取 实时
TX许可证 data.texas.gov Socrata API 实时API呼叫 实时（958K+记录）
FL许可证 MyFloridaLicense.com 实时抓取 实时
纽约许可证 纽约开放数据+DOB BIS 实时API+抓取 实时
人工费率 劳工统计局API API实时电话 实时（BLS每年更新一次）
材料价格 行业平均值（零售商、分销商） 本地JSON数据文件 每月更新
区域乘数 BLS地区工资数据+RSMeans 本地JSON数据文件 每年更新一次
保险/债券要求 州许可委员会法规 本地JSON数据文件 随着法律的变化而更新
项目成本估算 HomeAdvisor、Angi、RSMeans 本地JSON数据文件 每年更新一次

许可证验证和人工费率为 生活 --每个查询都指向真实的数据源。材料价格和合规数据存储在 trades_mcp/data/ 作为JSON文件 last_updated 时间戳，使其易于更新，无需更改代码。

定价

初学者 专业版
价格 29美元/月 49美元/月
许可证验证（4个州） 是 是
建筑许可证搜索 是 是
材料定价（20+材料） -- 是
劳工统计局劳动力费率（12个行业） -- 是
项目成本估算 -- 是
合规性跟踪 -- 是
区域成本比较 -- 是

低于一次材料价格查询服务的成本。它第一次为你节省了雇佣无牌承包商的费用。

保持数据新鲜

劳工率和地区乘数可以从BLS API自动更新：

# Update everything (labor rates, regional multipliers, material price review)
python scripts/update_data.py

# Update only labor rates
python scripts/update_data.py --only labor

# Update only regional multipliers
python scripts/update_data.py --only multipliers

# With a BLS API key for higher rate limits
python scripts/update_data.py --bls-key YOUR_KEY

材料价格需要手动更新（不存在免费的公共API）。脚本显示当前价格，并告诉您在哪里检查更新。

通过cron或任务调度器每月安排一次，以保持数据最新。

发展

# Clone and install
git clone https://github.com/Mahender22/trades-mcp.git
cd trades-mcp
pip install -e ".[dev]"

# Run tests (68 passing)
pytest -v

# Run server locally
trades-mcp

许可证

麻省理工学院 --随心所欲地使用它。

相关 MCP