topologicpy MCP

TopologicPy MCP服务器

这能带来什么

请Claude（或任何配备MCP的LLM）通过自然语言构建架构模型：

“创建一栋3层办公楼，12m×20m，层高3.5m，然后向我展示邻接图并导出到IFC”

MCP服务器将这些请求转换为精确的TopologicPy操作，在整个对话中维护一个命名对象会话。

建筑

┌─────────────────────────────────────────────────┐
│              MCP Client (Claude Code, etc.)       │
│  Natural language ↔ tool calls                   │
└────────────────────┬────────────────────────────┘
                     │  MCP Protocol (stdio/SSE)
                     ▼
┌─────────────────────────────────────────────────┐
│            TopologicPy MCP Server                │
│  ┌───────────────────────────────────────────┐  │
│  │  Session Store (named topology objects)    │  │
│  │  • "building" → CellComplex               │  │
│  │  • "floor_0"  → Cell                      │  │
│  │  • "graph"    → Graph                     │  │
│  └───────────────────────────────────────────┘  │
│                                                  │
│  Tools: create, boolean, transform, query, I/O   │
│  Resources: session state, BREP strings          │
│  Prompts: building envelope, adjacency, grids    │
└────────────────────┬────────────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────────────┐
│                  TopologicPy                     │
│  Vertex → Edge → Wire → Face → Shell → Cell     │
│  CellComplex → Cluster → Graph → Dictionary     │
│  OpenCASCADE (BREP) • IfcOpenShell (IFC)        │
└─────────────────────────────────────────────────┘

可用工具（36个工具）

创造

布尔运算

变换

查询与分析

图的运算

词典（元数据）

进口/出口

会话管理

安装

紫外线（推荐）

cd topologic-mcp-server
uv venv
source .venv/bin/activate
uv pip install -e .

使用pip

cd topologic-mcp-server
pip install -e .

用法

使用克劳德代码

添加到您的Claude Code MCP配置中(~/.claude/claude_code_config.json):

{
  "mcpServers": {
    "topologic": {
      "command": "python",
      "args": ["-m", "topologic_mcp"],
      "cwd": "/path/to/topologic-mcp-server"
    }
  }
}

或者直接使用紫外线：

{
  "mcpServers": {
    "topologic": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/topologic-mcp-server", "topologic-mcp"]
    }
  }
}

使用克劳德桌面

增添 claude_desktop_config.json:

{
  "mcpServers": {
    "topologic": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/topologic-mcp-server", "topologic-mcp"]
    }
  }
}

独立（标准传输）

python -m topologic_mcp

配备MCP检查员（用于测试）

mcp dev src/topologic_mcp/server.py

对话示例

创建一个简单的建筑

User: Create a 3-storey building, 10m × 15m, 3m floor height

Claude: [calls create_vertex, create_cell_prism × 3, translate × 2,
         create_cellcomplex_by_cells, query_topology]

Result: CellComplex "building" with 3 cells, 16 faces, 33 edges, 20 vertices

分析空间邻接性

User: Show me which floors share faces in the building

Claude: [calls create_graph_from_topology with via_shared_faces=True,
         get_sub_topologies to list cells, query each cell]

Result: Graph with 3 vertices (one per floor) and 2 edges
        (floor_0↔floor_1, floor_1↔floor_2)

布尔运算

User: Cut a 2m diameter hole through the middle of floor_1

Claude: [calls create_cell_cylinder for the hole, translate to position,
         boolean_difference to subtract from floor_1]

Result: Updated floor_1 with cylindrical void

许可证

GPL-3.0或更高版本（与TopologicPy的许可证相匹配）

贡献

该服务器包装了TopologyPy的pure-Python API。要添加新工具，请执行以下操作：

1. 添加一个 @mcp.tool() 装饰功能 server.py
2. 遵循命名约定： verb_noun （例如。， create_vertex, export_brep)
3. 始终接受 ctx: Context 作为第一个参数
4. 使用 TopologyStore 从 ctx.request_context.lifespan_context
5. 返回描述性字符串（LLM读取这些字符串）