ifc-ruhsat
This server lets you inspect and check IFC building models against Türkiye's building-permit BIM regulation (ifc-ruhsat).
Run a full regulation compliance check on an IFC file, returning findings by severity, article reference, EK-9 row, and GlobalIds.
Generate the official EK-9 Model Quality Control Form as Markdown.
Get a model summary: IFC schema, authoring software, project/site/building/floor structure, space count, and entity counts by class.
List mandatory and optional IFC classes from EK-5 with Turkish names and 3-letter category codes, optionally filtered by search term.
Retrieve required attributes, property sets (Pset_/Qto_/TREpys_), and predefined types for a specific IFC class per EK-6/EK-7.
Get reference information about the regulation, official gazette details, phased IFC deadlines, and data sources used by the tool.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ifc-ruhsat proje.ifc yönetmeliğe uygun mu? EK-9 formunu hazırla"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ifc-ruhsat
Yapı ruhsatı IFC modelini yönetmeliğe göre kontrol eder. Türkiye'de 1 Eylül 2027'de yürürlüğe giren Mimarlık ve Mühendislik Projelerinin Dijital Olarak Hazırlanması Hakkında Yönetmelik (Resmî Gazete 5.8.2026, sayı 33331) her ruhsat projesinin IFC modelini 241 sayfalık eklere uydurmayı ve her teslimde EK-9 Model Kalite Kontrol Formu düzenlemeyi zorunlu kılıyor. Bu araç o ekleri makine kuralına çevirir: modeli okur, eksikleri madde numarasıyla söyler, EK-9 formunu doldurur. Komut satırından ya da Claude / Cursor gibi istemcilerden (MCP) kullanılır; yazılımdan bağımsızdır — Revit, Archicad, Allplan, Bonsai, hepsi IFC verir.
Otomatik ön kontroldür. Yönetmeliğin bazı satırları (LOD, mahal geometrisi, PDF–IFC uyumu) makinece denetlenemez; araç bunları "elle" diye açıkça bırakır, uygun saymaz. Nihai değerlendirme proje müellifi ile ilgili idareye aittir; bu araç hukuki görüş değildir.
uvx ifc-ruhsat kontrol 123456_00_MM_GNEL_MD_BIM_000_01_000.ifcornekler\hatali_ornek.ifc — IFC4X3
10 hata, 3 uyarı, 8 elle kontrol, 7 bilgi
X [m.11, EK-5 5.5 ve Tablo 5.3 · EK-9 m.5] 1 varlığın adı şablona uymuyor. Beklenen: iki harf disiplin,
üç harf kategori kodu ve açıklama, orta tire ile (örn. MM-DVR-dis_20cm) …
3U9N2MO4vDDA4Hfy2J54b4
X [EK-7 Tablo 7.6 · EK-9 m.6] IfcProjectedCRS.Name 'EPSG:3857'; TUREF 3° dilimlerinden biri olmalı:
EPSG:5253 … EPSG:5259.
X [EK-6 Tablo 6.66 · EK-9 m.9] IfcWall: Pset_WallCommon.FireRating (Yangın Dayanım Sınıfı) 1 varlıkta yok ya da boş.
3U9N2MO4vDDA4Hfy2J54b4
X [EK-6 6.1.3 · EK-9 m.17] 1 varlık IfcProxy/IfcBuildingElementProxy ile modellenmiş; yönetmelik vekil sınıfa izin vermez …
? [EK-9 madde 7] Gelişim seviyesi (LOD 300) geometrinin ayrıntısına bakılarak elle değerlendirilir.Tam örnek: ornekler/hatali_ornek.EK-9.md — 21 satırlık EK-9 formu, her satırda Evet / Hayır / Kısmen / Elle ve dayanağı.
Kurulum
Python 3.10+ yeterli. uv varsa kurulum gerekmez, uvx ifc-ruhsat … yeter. Kalıcı kurulum:
pip install ifc-ruhsatRelated MCP server: IFCX MCP
Komutlar
Komut | Ne yapar |
| Bütün kuralları çalıştırır; hata varsa çıkış kodu 1 (CI'da kullanılabilir). |
| EK-9 Model Kalite Kontrol Formu (Tablo 9.1), Markdown |
| Şema, üreten yazılım, proje/saha/bina/katlar, sınıf sayıları |
| EK-6 ve EK-7'yi buildingSMART IDS dosyası olarak yazar ( |
| MCP sunucusu (stdio; |
MCP ile kullanım
Claude Desktop, Claude Code, Cursor ve MCP konuşan her istemci:
{
"mcpServers": {
"ifc-ruhsat": { "command": "uvx", "args": ["ifc-ruhsat", "mcp"] }
}
}Sonra asistanınıza sorun: "C:\proje\A_blok.ifc yönetmeliğe uyuyor mu, EK-9 formunu çıkar", "IfcSlab için hangi özellikler zorunlu?", "Kolonlarda neden hata var, hangi maddeye göre?"
Araç | Ne yapar |
| Modeli denetler; her bulgu seviye, madde, EK-9 satırı ve GlobalId listesiyle |
| EK-9 formunu Markdown üretir |
| Şema, yazılım, iskelet, sınıf sayıları |
| Zorunlu / isteğe bağlı IFC sınıfları, Türkçe adları ve kategori kodları |
| Bir sınıf için zorunlu öznitelik ve özellik setleri (EK-6 / EK-7) |
| Dayanak, kademeli takvim, veri kaynakları |
Model araçları (model_ozeti, yonetmelik_kontrolu, ek9_formu) dosyayı dosya (yol) ya da ifc_metni (IFC metni, + dosya_adi) ile alır. Bütün araçlar salt okurdur ve MCP ek açıklamalarını (readOnlyHint, destructiveHint: false, idempotentHint, openWorldHint: false) taşır; her aracın açıklamasında ne zaman kullanılacağı, girdi örnekleri ve dönüş biçimi yazar.
Sunucu yalnızca verilen dosyayı okur; ağa hiçbir şey göndermez, kalıcı bir şey yazmaz. Cline gibi ajanlar kurulumu llms-install.md ile kendi başına yapabilir.
Uzak sunucu (Docker)
ifc-ruhsat mcp --http sunucuyu streamable HTTP ile http://<host>:8080/mcp adresinde açar (durumsuz; birden çok kopya yük dengeleyici arkasında çalışır). Hazır imaj her v* sürümünde yayımlanır:
docker run --rm -p 8080:8080 -e IFC_RUHSAT_API_KEY=gizli ghcr.io/berkantacun/ifc-ruhsatOrtam değişkeni | Varsayılan | Anlamı |
|
| Dinlenecek adres (Azure Container Apps IPv6 desteklemediği için IPv4) |
|
| Port |
| — | Verilirse her istekte |
İstemci tarafı:
{
"mcpServers": {
"ifc-ruhsat": {
"type": "http",
"url": "https://sunucu.example.com/mcp",
"headers": { "X-API-Key": "gizli" }
}
}
}Uzak modda dosya parametresi güvenlik gereği kapalıdır: sunucu kendi diskinden hiçbir yol okumaz, verilirse araç uzak-dosya-kapali hatası döner. Modeli ifc_metni ile gönderin (sunucu onu geçici bir klasörde açar, iş bitince siler). İmaj Python 3.12 slim üzerinde, root olmayan kullanıcıyla (uid 10001) çalışır. Anahtar yalnız basit bir paylaşımlı sırdır; sunucuyu internete açarken TLS sonlandıran bir ters vekil (Container Apps ingress gibi) arkasında çalıştırın.
Ne denetleniyor
EK-9 satırı | Kontrol | Durum |
2 Proje bilgileri | IfcProject, IfcPerson, IfcOrganization, IfcPersonAndOrganization öznitelikleri (EK-7 Tablo 7.1–7.5) | otomatik |
3 Dosya/proje adı | EK-2 Tablo 2.1 dokuz alan; IfcProject.Name | otomatik (alt disiplin/dosya türü kodları listeyle karşılaştırılmıyor) |
4 Mahal no/ismi | IfcSpace.Name | otomatik |
5 Varlık adları |
| otomatik |
6 Koordinat | IfcProjectedCRS (EPSG:5253–5259, datum, zon, birim) + IfcMapConversion (EK-7 Tablo 7.6–7.7) | otomatik |
7 LOD 300 | — | elle |
8 / 17 Sınıflar | EK-5 zorunlu + isteğe bağlı liste; IfcProxy / IfcBuildingElementProxy yasak; üst sınıf yerine alt sınıf | otomatik + elle (anlam) |
9 / 20 Öznitelik ve özellikler | EK-6'nın 68 zorunlu sınıf tablosunun tamamı: Name, Tag, malzeme (Ad_Dayanım), IfcSystem bağı, katman, Pset_/Qto_/TREpys_ özellikleri, veri tipi, izinli değerler; yanlış sette bulunan özellik ayrıca | otomatik |
10 Emsal | IfcSpatialZone alanları EmsalDurumu'na (DAHIL/HARIC/DIGER) göre toplanır, KAKS × parsel alanıyla karşılaştırılır | kısmen (pafta tablosuyla karşılaştırma elle) |
11 İskelet | Proje, Saha, Bina, ≥1 Kat; tek IfcProject | otomatik |
12 Mahal var mı | mimari disiplinde IfcSpace | otomatik |
13–14 Mahal geometrisi | her mahalin hacimli 3B gövdesi var; aynı kattaki mahallerin sınır kutuları %10'dan fazla örtüşmüyor | otomatik (kutu tabanlı, kaba) |
15 Kata bağlılık ve kot | her eleman bir kata bağlı; gövdesi katın kotu ile üst katın kotu arasında (±1,5 m) | otomatik |
16 Yinelenen | tekrar eden GlobalId; aynı sınıf+ad+yerleşim | otomatik |
18 IFC sürümü | IFC4X3, | otomatik |
19 Ön Tanımlı Tip | boş / NOTDEFINED; USERDEFINED ise ObjectType | otomatik |
1, 21 | dosya boyutu sınırı yayımlanmadı; PDF–IFC uyumu | elle |
EK-6'nın 68 zorunlu sınıf tablosunun tamamı nihai Resmî Gazete ekinden sayfa sayfa okunup kodlandı; her öznitelik IFC 4.3 şemasına, her özellik buildingSMART'ın resmî Pset şablonlarına karşı testle doğrulanır. Hangi tablonun hangi sayfadan geldiği: KAYNAKLAR.md. Geometri kontrolleri (mahal gövdesi, örtüşme, kot) sınır kutusu tabanlıdır — hızlı ve kaba; L biçimli mahallerde yanlış alarm verebilir, bunu bulgu metni de söyler.
Gerçek modellerde ne çıkıyor
Halka açık üç modelde, hiçbir şey değiştirmeden (bu modeller yönetmelik yokken yapıldı; sonuç "hazırlık ne kadar" sorusunun cevabıdır):
Model | Şema | Süre | Hata / uyarı | Öne çıkanlar |
buildingSMART resmî IFC 4.3 örneği, Building-Architecture.ifc (SketchUp, 21 varlık) | IFC4X3 | < 1 s | 32 / 5 | Koordinat sistemi EPSG:32760 (Türkiye dilimi değil); 2 vekil sınıf; mahal numaraları ve |
Revit 2021 konut, Ifc4_Revit_ARC.ifc (13 MB, 522 varlık) | IFC4 | 1,7 s | 47 / 12 | IFC 4.3 değil; 66 IfcBuildingElementProxy; 511 varlık adı şablon dışı; 47 duvarda FireRating yok; IfcPlate (44 giydirme cephe paneli) yönetmelik listesinde yok; hiç IfcSpace yok; koordinat sistemi yok |
IfcOpenShell örnek evi, Ifc4_SampleHouse.ifc (2 MB) | IFC4 | < 1 s | 40 / 9 | IFC4; IfcWallStandardCase (4.3'te kaldırıldı); malzeme adları |
Ders: bugünkü tipik bir Revit çıktısı ile yönetmeliğin istediği dosya arasındaki fark büyük ama sayılabilir — IFC 4.3'e geçiş, vekil sınıfların sınıflandırılması, isimlendirme şablonu, yangın/kullanım özellikleri ve Türkiye'ye özel parsel/emsal setleri. Araç bu listeyi GlobalId'leriyle veriyor. Bir de yönetmeliğin kendi boşluğu görünüyor: Revit'in giydirme cephe panellerini attığı IfcPlate EK-5'in iki listesinde de yok (KAYNAKLAR.md).
Yönetmelik ne diyor, kısaca
Ruhsat eki projeler BIM tabanlı hazırlanır, IFC 4.3 (TS EN ISO 16739-1) teslim edilir; 2B paftalar modelden üretilip PDF/A verilir (m.4, m.9).
Varlıklar EK-5'teki sınıflarla,
Disiplin-KategoriKodu-Açıklamaadıyla modellenir (m.11, EK-5); vekil sınıf yasak (EK-6 6.1.3).Her sınıf için EK-6'daki öznitelik ve özellik setleri, projeler için EK-7 (Türkiye'ye özel
TREpys_setleri dahil) doldurulur (m.12–13).Model LOD 300'dür (EK-8); her teslimde EK-9 formu düzenlenir (m.15).
Takvim (Geçici m.1): yürürlük 1.9.2027; IFC teslimi 1.9.2029'dan itibaren büyükşehirlerdeki >10.000 m² projelerle başlar, 1.9.2032'de bütün binalar, 1.9.2033'te konut dışı.
Metin: Resmî Gazete 20260805-2 · Ekler (241 s.): 20260805-2-1.pdf
Kendi kurallarınız
Yönetmelik verisi src/ifc_ruhsat/ekler/*.json içinde, her dosya kaynağını kendi kaynak alanında söyler. Bir EK-6 tablosu eklemek: ilgili Resmî Gazete sayfasını okuyup ek6_ozellikler.json'a satırı ve sayfa numarasını yazın, testleri çalıştırın. Kural eklemek: src/ifc_ruhsat/kurallar/ altına kontrol(baglam) -> list[Bulgu] imzasıyla bir modül, kontrol.py'daki MODULLER'e bir satır. Her bulgu bir maddeye ve bir EK-9 satırına bağlanmak zorundadır; dayanağı olmayan kural eklenmez.
uv sync && uv run pytest && uv run ruff check .English
ifc-ruhsat checks an IFC model against Türkiye's building-permit BIM regulation (Official Gazette 5 Aug 2026, no. 33331; in force 1 Sep 2027; IFC delivery phased in from Sep 2029). It encodes the regulation's annexes — mandatory IFC 4.3 classes and 3-letter category codes (Annex 5), per-class attribute and property-set requirements including the Turkish TREpys_ sets (Annex 6), project/person/organisation and TUREF coordinate requirements (Annex 7) — and fills in the 21-row model quality-control form (Annex 9). Findings cite the article and annex table and list GlobalIds. Vendor-neutral (IfcOpenShell), usable as a CLI, as an MCP server for Claude/Cursor, and as buildingSMART IDS files for Solibri/BIMcollab/usBIM. It is an automated pre-check, not legal advice; rows that cannot be verified by machine are reported as manual, never as passed.
Lisans
MIT. Yönetmelik metni ve ekleri kamu belgesidir; buradaki JSON dosyaları o eklerin makine biçimidir, hangi sayfadan alındığı her birinde yazılıdır.
mcp-name: io.github.BerkantACUN/ifc-ruhsat
Available Tools
6 toolsek5_siniflarARead-only
EK-5'teki zorunlu (Tablo 5.1) ve isteğe bağlı (Tablo 5.2) IFC sınıfları, Türkçe adı ve üç
harfli kategori koduyla; ara ile sınıf/Türkçe ad filtresi. Lists the regulation's mandatory
and optional IFC classes with their Turkish names and 3-letter category codes.
Inputs: ara. Returns: object
ek6_gerekenlerBRead-only
Bir IFC sınıfı için yönetmeliğin istediği zorunlu öznitelikler, özellik setleri (Pset_/Qto_/TREpys_) ve Ön Tanımlı Tip listesi — EK-6 (yapı elemanları) ya da EK-7 (proje, kişi, kuruluş, koordinat). Kodlanmamış bir sınıf için bunu açıkça söyler. Required attributes and property sets for one IFC class per Annex 6/7.
Inputs: ifc_sinifi (required). Returns: object
ek9_formuBRead-only
EK-9 Model Kalite Kontrol Formu'nu (Tablo 9.1, 21 satır) Markdown olarak üretir; her satır Evet / Hayır / Elle ve dayanağıyla. Renders the regulation's model quality-control form (Annex 9) for the model as Markdown.
Inputs: dosya (required), disiplin. Returns: result
model_ozetiBRead-only
IFC dosyasının kimliği: şema (IFC4X3 olmalı), üreten yazılım, proje/saha/bina/kat adları, mahal sayısı ve sınıf başına varlık sayıları. Summary of an IFC file: schema, authoring software, spatial structure and entity counts by class.
Inputs: dosya (required). Returns: object
yonetmelik_bilgisiARead-only
Aracın dayandığı yönetmelik, Resmî Gazete tarihi/sayısı, yürürlük ve kademeli IFC takvimi, veri dosyalarının kaynak satırları ve araç sürümü. Which regulation this tool encodes, with the phased deadlines.
Inputs: no named parameters. Returns: object
yonetmelik_kontroluARead-only
Modeli yönetmeliğe göre denetler: IFC sürümü, Proje/Saha/Bina/Kat iskeleti, EK-5 sınıf
listesi ve yasak vekil sınıflar, EK-5 isimlendirme (Disiplin-Kategori-Açıklama), EK-6/EK-7
zorunlu öznitelik ve özellik setleri (TREpys_ dahil), koordinat sistemi (TUREF EPSG:5253–5259),
kat bağı, yinelenen varlıklar, emsal toplamları. Her bulgu: seviye (hata/uyari/elle/bilgi),
madde, EK-9 satırı, GlobalId listesi. Checks an IFC model against the Turkish building-permit
BIM regulation and returns findings with article references. disiplin: EK-2 kodu (MM mimari, ST statik, MK mekanik, EE elektrik); verilmezse dosya adından, yoksa MM.
Inputs: dosya (required), disiplin. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a distinct purpose: model summary, compliance check, form generation, class listing, attribute requirements, and regulation metadata. There is no overlap or ambiguity between them.
All tool names follow a consistent pattern: lowercase Turkish nouns with underscores, e.g., model_ozeti, yonetmelik_kontrolu. No mixing of conventions or verb styles.
6 tools is well-scoped for the IFC regulation-checking domain. Each tool provides a distinct capability without being redundant or overwhelming.
The tool set covers the core workflow: summary, compliance check, annex forms, class reference, and attribute requirements. Minor gap: no dedicated tool for Annex 7 alone, but ek6_gerekenler handles both Annex 6 and 7.
Maintenance
Related MCP Connectors
Convert Revit files to XKT, IFC, or DWG and query BIM data via natural language.
Design buildings as IFC4 BIM models from a brief: an AI architect that plans, builds and edits.
Check floor-plan images, trace them into editable plans, export PDF and IFC, and query IFC models.
AI Hub for AEC — 50+ 3D formats, clash detection, ACC integration via Autodesk Platform Services.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides AI-powered access to Turkish building regulations, architectural standards, and construction calculation tools via the Model Context Protocol.MIT
- AlicenseCqualityDmaintenanceEnables AI assistants to create, edit, and export IFC5/IFCX building information models through natural language, handling spatial structure, elements, geometry, metadata, validation, and export.7326MIT
- AlicenseAqualityDmaintenanceEnables AI agents to load, query, and analyze IFC building model files, including spatial structures, elements, properties, materials, and geometry.201MIT
- AlicenseAqualityDmaintenanceAn MCP server that lets users query, validate, convert, and compare IFC/BIM files using natural language. Runs fully locally and integrates with AI agents like Claude.8MIT