建筑数据字典查询服务

bSDD MCP服务器为建筑信息模型(BIM)提供标准化的建筑分类、属性和数据字典查询功能,用于AI助手如Claude进行BIM模型丰富。

  • by JardiMargalefAgusti
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 JardiMargalefAgusti/bSDD-mcp

使用说明

bSDD MCP服务器

MCP服务器 buildingSMART数据字典(bSDD) API使Claude等人工智能助手能够查询标准化的建筑分类、属性和数据字典,以丰富BIM模型。

什么是bSDD?

buildingSMART数据字典是一个在线服务,承载分类及其属性、允许值、单位、翻译和关系。它提供了一种标准化的方法来描述跨多个分类系统的建筑元素,例如 工业基础类, ETIM, 统一分类, OmniClass,以及更多。

特性

此MCP服务器公开 9工具 要查询bSDD API:

工具 说明
bsdd_list_dictionaries 列出可用词典(IFC、ETIM、UniClass等)
bsdd_get_dictionary_classes 浏览字典的类层次结构
bsdd_get_class 获取包含属性和关系的完整类详细信息
bsdd_search_classes 在字典中按关键字搜索类别
bsdd_get_class_properties 获取类的属性(数据类型、单位、允许的值)
bsdd_get_class_relations 获取类之间的关系
bsdd_get_property 获取属性详细信息(类型、单位、约束)
bsdd_get_property_classes 查找哪些类使用给定的属性
bsdd_text_search 在所有bSDD内容中进行自由文本搜索

不需要API密钥-使用bSDD公共读取终结点。

安装

先决条件

设置

  1. 克隆仓库
git clone https://github.com/JardiMargalefAgusti/bSDD-mcp.git
cd bSDD-mcp
  1. 安装依赖项
npm install
  1. 构建
npm run build
  1. 配置Claude桌面

打开克劳德桌面设置: 设置→ 开发者→ 编辑配置

在内部添加以下条目 "mcpServers":

{
  "mcpServers": {
    "bSDD": {
      "command": "node",
      "args": ["/absolute/path/to/bSDD-mcp/build/index.js"]
    }
  }
}

替换 /absolute/path/to/bSDD-mcp 使用克隆存储库的实际路径。

Windows示例:

"args": ["C:\\Users\\youruser\\bSDD-mcp\\build\\index.js"]

macOS/Linux示例:

"args": ["/Users/youruser/bSDD-mcp/build/index.js"]
  1. 重新启动克劳德桌面

9 bsdd_* 工具现在应该出现在您的工具列表中。

用法示例

连接后,您可以问Claude以下问题:

  • “列出所有可用的bSDD词典”
  • “根据IFC 4.3,IfcWall应该拥有哪些属性?”
  • “在bSDD中搜索耐火性能”
  • “获取IfcDoor及其属性集的类定义”
  • “哪些IFC类使用AcousticRating属性?”
  • “显示配电盘的ETIM分类”
  • “FireRating属性的允许值是多少?”

BIM丰富工作流程

该服务器旨在与其他BIM相关的MCP服务器协同工作:

bSDD+IFC查看器(BIM生成器)

  1. 查询bSDD以获取IFC类的标准特性
  2. 检查加载的IFC模型中缺少哪些属性
  3. 创建PropertySet并添加标准化属性

bSDD+Revit(FlowRun)

  1. 在bSDD中搜索分类代码和所需属性
  2. 在Revit中生成共享参数
  3. 按类别/类型分配标准化值

项目结构

bSDD-mcp/
├── src/
│   ├── index.ts              # MCP server entry point (stdio transport)
│   ├── bsdd-client.ts        # HTTP client for bSDD REST API
│   ├── tools/
│   │   ├── dictionaries.ts   # Dictionary browsing tools
│   │   ├── classes.ts        # Class lookup, search, properties, relations
│   │   ├── properties.ts     # Property details and reverse-lookup
│   │   └── search.ts         # Free-text search
│   └── types/
│       └── bsdd.ts           # TypeScript interfaces for API responses
├── package.json
├── tsconfig.json
└── build/                    # Compiled JavaScript (generated)

API 参考

此服务器使用 bSDD REST API:

  • 基本URL: https://api.bsdd.buildingsmart.org
  • 身份验证:无需(公共读取访问)
  • 文档: bSDD API文档

许可证

麻省理工学院