交易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许可证
麻省理工学院 --随心所欲地使用它。