能力标签

🔌

MCP工具

建筑HUB-MCP

基于 Python · 让 AI 助手直接操作你的系统与工具

英文名：archhub-mcp

⭐ 9 Stars 💻 Python 📄 MIT 🏷 AI 8.0分

8.0AI 综合评分

archhubbuildingkoreamcppython

⬇ 下载源码 ZIP ⚙️ 配置说明

✦ AI Skill Hub 推荐

建筑HUB-MCP 是 AI Skill Hub 本期精选MCP工具之一。综合评分 8.0 分，整体质量较高。我们强烈推荐将其纳入你的 AI 工具库，帮助提升工作效率。

📚 深度解析

建筑HUB-MCP 是一款基于 MCP（Model Context Protocol）标准协议的 AI 工具扩展。MCP 协议由 Anthropic 开发并开源，旨在建立 AI 模型与外部工具之间的标准化通信接口，目前已被 Claude Desktop、Claude Code、Cursor 等主流 AI 工具采纳。

通过安装建筑HUB-MCP，你的 AI 助手将获得额外的工具调用能力，可以用自然语言直接操控该工具的功能，无需学习复杂的命令行语法。MCP 工具的核心价值在于"一次配置，永久增强"——配置完成后，每次与 AI 对话时都可以无缝调用这些工具。

在技术实现上，MCP 工具通过标准的 JSON-RPC 协议与 AI 客户端通信，工具的功能以"工具列表"的形式暴露给 AI 模型，AI 可以按需调用。建筑HUB-MCP 提供了结构化的工具调用接口，使 AI 模型能够精确地理解和使用每个功能点，显著降低 AI 在工具使用上的错误率。

与传统的 API 集成相比，MCP 工具的优势在于无需编写代码——用户只需在配置文件中添加几行 JSON，即可让 AI 获得全新能力。AI Skill Hub 将建筑HUB-MCP 评为 AI 评分 8.0 分，属于同类工具中的优质选择。

📋 工具概览

建筑HUB-MCP 是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。

GitHub Stars

⭐ 9

开发语言

Python

支持平台

Windows / macOS / Linux

维护状态

轻量级项目，按需更新

开源协议

MIT

AI 综合评分

8.0 分

工具类型

MCP工具

Forks

—

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

📌 核心特色

通过标准 MCP 协议与 Claude、Cursor 等主流 AI 客户端深度集成
提供结构化工具调用接口，显著降低 AI 集成复杂度
支持 Claude Desktop 和 Claude Code 无缝接入，开箱即用
可与其他 MCP 工具组合叠加，构建完整 AI 工作站
轻量无侵入设计，不影响现有系统架构

🎯 主要使用场景

在 Claude Desktop 对话中直接调用本地工具，实现 AI 与系统的深度联动
通过自然语言驱动复杂的多步骤自动化任务，代替繁琐手动操作
将多个 MCP 工具组合使用，构建个人专属 AI 工作站

以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。

安装命令

# 方式一：通过 Claude Code CLI 一键安装
claude skill install https://github.com/chrisryugj/archhub-mcp

# 方式二：手动配置 claude_desktop_config.json
{
  "mcpServers": {
    "--hub-mcp": {
      "command": "npx",
      "args": ["-y", "archhub-mcp"]
    }
  }
}

# 配置文件位置
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%/Claude/claude_desktop_config.json

📋 安装步骤说明

确认已安装 Node.js（v18 或以上版本）
打开 Claude Desktop 或 Claude Code 的 MCP 配置文件
按「交给 Agent 安装 → Claude Desktop」标签中的 JSON 配置填入 mcpServers 字段
保存配置文件并重启 Claude 客户端
重启后，在对话中即可使用本工具

以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。

常用命令 / 代码示例

# 安装后在 Claude 对话中直接使用
# 示例：
用户: 请帮我用 建筑HUB-MCP 执行以下任务...
Claude: [自动调用 建筑HUB-MCP MCP 工具处理请求]

# 查看可用工具列表
# 在 Claude 中输入："列出所有可用的 MCP 工具"

以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。

配置示例

// claude_desktop_config.json 配置示例
{
  "mcpServers": {
    "__hub-mcp": {
      "command": "npx",
      "args": ["-y", "archhub-mcp"],
      "env": {
        // "API_KEY": "your-api-key-here"
      }
    }
  }
}

// 保存后重启 Claude Desktop 生效

📑 README 深度解析真实文档完整度 33/100 查看 GitHub 原文 →

以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

건축HUB MCP

국토교통부 건축HUB 3개 API를 11개 도구로. 건축물대장·건축인허가·주택인허가 + 법정동코드 조회 + 용도지역 포함 종합카드 + 층별 구성 + 동 단위 통계·규모 벤치마크 + 노후건축물 분석 + 공시가격 시계열 + 철거멸실(석면) + 인허가 파이프라인을 AI 어시스턴트에서 자연어로 바로.

국가법령정보 MCP가 "법령"을, 통계 MCP가 "통계"를 다루듯, 이건 건축물 실체 데이터를 다룬다. 건축물대장 · 건축인허가 · 주택인허가 — data.go.kr 공식 API 실측값만, 출처를 명시하고, 없으면 [NOT_FOUND]로 환각을 차단.

remote 커넥터(fly.io)가 떠 있어, 사용자는 URL만 등록하면 별도 설정 없이 바로 쓴다.

---

1. `building_profile` — 용도지역 포함 한 필지 종합카드

표제부와 지역지구구역을 호출해 용도지역(법적 규제) + 주용도·구조·규모·건폐율/용적률·세대/주차·사용승인·내진·에너지효율을 한 카드로 묶는다. 건축의 출발점인 "이 땅 무슨 지역이고, 지금 뭐가 얼마나 서 있나"를 1콜로. (건축사·시공·중개·감정평가)

"자양동 2-2번지 건물 정보 한눈에 보여줘"
→ building_profile(11215, 10500, bun=2, ji=2)

건축물 1개 동
용도지역·지구: 지구단위계획구역 · 일반상업지역

■ 건대입구역자이엘라
  위치: 서울특별시 광진구 능동로 87 (자양동)
  용도: 업무시설 (기타: 업무시설(오피스텔),근린생활시설,문화및집회시설,공공업무시설)  ·  구조: 철골철근콘크리트합성구조
  규모: 지상20/지하6층 · 높이 99.6m · 연면적 28,515.35㎡ · 대지 2,288.50㎡
  건폐율 59.9781% · 용적률 787.882%
  세대: 0세대 0가구 366호
  주차: 자주식 115대 · 기계식 120대
  사용승인 2022-10-07 · 허가 2018-04-18 · 착공 2019-09-26
  내진 1(Ⅶ-0.176g)

출처: 국토교통부 건축HUB (공공데이터포털 data.go.kr)

건폐율/용적률이 응답에 없으면 면적으로 직접 계산해 (계산) 표시 — 추정과 실측을 구분한다. 용도지역 정보가 없는 필지(주로 오래된 단독주택)는 해당 줄을 조용히 생략한다.

2. `building_floors` — 층별 구성 스택

층별개요를 호출해 옥탑→지상→지하 순으로 각 층의 용도·면적을 쌓아 보여준다. 한 층에 여러 용도가 있으면 합산해 나열. 리모델링·용도변경·임대구성·피난/소방 검토에. (건축사·시공·중개)

"자양동 2-2번지 층별로 뭐가 있는지 보여줘"
→ building_floors(11215, 10500, bun=2, ji=2)

■ 층별 구성 — 건대입구역자이엘라
  총 27개 층 (행 31건)

     옥탑         73㎡  오피스텔 73㎡
    20층        732㎡  오피스텔 732㎡
     ...
     6층      1,242㎡  예식장 1,242㎡
     5층      1,242㎡  일반음식점 1,242㎡
     3층      1,890㎡  기타공공업무시설 1,799㎡ · 놀이형시설 91㎡
     1층      1,229㎡  일반음식점 1,060㎡ · 오피스텔 169㎡
   지하1층      1,481㎡  일반음식점 1,481㎡
   지하6층      1,812㎡  오피스텔 1,812㎡

출처: 국토교통부 건축HUB (공공데이터포털 data.go.kr)

4. `old_buildings` — 노후건축물 선별

동 전체 표제부에서 사용승인 경과연수를 계산해 노후 건물을 내림차순 정렬. 안전점검·정비사업 대상 1차 선별에 바로 쓴다.

"자양동에서 40년 넘은 노후 건물 뽑아줘"
→ old_buildings(11215, 10500, min_age_years=40)

총 1551건 중 상위 30건 표시
표제부 6057건 중 경과 40년↑ 1551건 (경과연수 내림차순)

건물명  도로명대지위치   대지위치               주용도코드명  사용승인일   경과연수  연면적  지상층수  세대수
            서울특별시 광진구 자양동 268번지   단독주택  1924-07-20    102  16.53     1    0
            서울특별시 광진구 자양동 203번지   단독주택  1926-08-20    100  59.50     1    0
            ...

6. `demolitions` — 철거멸실 현황 (석면 포함)

철거멸실관리대장을 최근 철거순으로, 연면적·용도·구조 + 석면 함유 부위(천장/단열/지붕/보온/바닥/기타)를 ⚠로 요약. 석면은 철거 안전·비용에 직결된다. 개발·멸실 신호 파악에. (디벨로퍼·철거업체·공무원)

"자양동 2018년 이후 철거된 건물 보여줘"
→ demolitions(11215, 10500, since_year=2018)

[철거멸실 현황] 철거멸실 1771건 중 2018년↑ 248건 (최근 철거순)

■ 서울특별시 광진구 자양동 680-63번지
  철거 · 방송통신시설 · 철골콘크리트구조 · 연면적 34,995.78㎡ · 철거 2020-05-02~2020-10-31 ⚠석면(천장·단열·지붕·보온)
■ 서울특별시 광진구 자양동 680-22번지
  철거 · 업무시설 · 철골콘크리트구조 · 연면적 21,558.33㎡ · 철거 2020-05-02~2020-10-31 ⚠석면(천장·보온)
...

7. `permits_pipeline` — 인허가 파이프라인

건축인허가 기본개요에서 허가는 났으나 사용승인 전(진행중) 건만 추려 허가일 최근순으로. 실제착공일 유무로 착공/미착공 단계를 구분해 신규 공급 파이프라인을 본다. (디벨로퍼·공무원)

"자양동 진행 중인 건축 인허가 보여줘"
→ permits_pipeline(11215, 10500, since_year=2024)

[인허가 파이프라인] 기본개요 5358건 중 진행중(사용승인 전) 1243건 · 허가 2024년↑

■ 서울특별시 광진구 자양동 613-24번지
  신축 · 공동주택 · 연면적 419.12㎡ 12세대 · 허가 2026-04-27 · 단계: 미착공
■ 서울특별시 광진구 자양동 854번지
  발코니구조변경 · 공동주택 · 연면적 52,666.24㎡ 204세대 · 허가 2026-04-22 · 단계: 미착공
...