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"
}
}
}