adventurous-systems/topologicpy_mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
a model context protocol server for topologicpy
개요
A Model Context Protocol server that exposes TopologicPy TopologicPy-docs's spatial modeling capabilities to LLM agents like Claude Code, Claude Desktop, and other MCP clients. This was created to assist us in developing further tools around Topologic and TopologicPy Ask Claude (or any MCP-equipped LLM) to build architectural models through natural language: "Create a 3-storey office building, 12m × 20m with 3.5m floor heights, then show me the adjacency graph and export to IFC" The MCP server translates these requests into precise TopologicPy operations, maintaining a named object session across the conversation. Add to your Claude Code MCP configuration (~/.claude/claude_code_config.json): GPL-3.0-or-later (matching TopologicPy's license) This server wraps TopologicPy's pure-Python API. To add new tools: 1. Add a @mcp.tool() decorated function in server.py 2. Follow the naming convention: verb_noun (e.g., create_vertex, export_brep) 3.
README
원문 README의 일부입니다. 원문 보기.
TopologicPy MCP Server
A Model Context Protocol server that exposes TopologicPy TopologicPy-docs’s spatial modeling capabilities to LLM agents like Claude Code, Claude Desktop, and other MCP clients. This was created to assist us in developing further tools around Topologic and TopologicPy
What This Enables
Ask Claude (or any MCP-equipped LLM) to build architectural models through natural language:
“Create a 3-storey office building, 12m × 20m with 3.5m floor heights, then show me the adjacency graph and export to IFC”
The MCP server translates these requests into precise TopologicPy operations, maintaining a named object session across the conversation.
Architecture
┌─────────────────────────────────────────────────┐
│ 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) │
└─────────────────────────────────────────────────┘
Available Tools (36 tools)
Creation
| Tool | Description |
|---|---|
create_vertex |
Create a point at (x, y, z) |
create_edge |
Line segment between two vertices |
create_wire |
Polyline from ordered vertices |
create_face_by_wire |
Face from a closed wire |
create_face_rectangle |
Rectangular face |
create_face_circle |
Circular face (polygon approximation) |
create_cell_by_faces |
3D solid from bounding faces |
create_cell_prism |
Box / rectangular prism |
create_cell_cylinder |
Cylindrical cell |
create_cellcomplex_by_cells |
Merged cell assembly (shared boundaries) |
create_cluster |
Unstructured collection |
Boolean Operations
| Tool | Description |
|---|---|
boolean_union |
A ∪ B |
boolean_difference |
A − B |
설치
This server does not publish a one-line install command.
Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →설정
{
"mcpServers": {
"topologic": {
"command": "python",
"args": ["-m", "topologic_mcp"],
"cwd": "/path/to/topologic-mcp-server"
}
}
}