Archicad MCP

🚀 archicad-mcp

archicad-mcp 是一個為 Graphisoft Archicad 運行 MCP 服務器 的框架。它藉助 Tapir 插件及其額外的 JSON 命令，讓諸如 Anthropic 的 Claude 等 MCP 客戶端能夠與 Archicad 進行交互。

🚀 快速開始

archicad-mcp 是一個為 Graphisoft Archicad 運行 MCP 服務器的框架，藉助 Tapir 插件及額外 JSON 命令，實現 MCP 客戶端與 Archicad 的交互。

📦 安裝指南

Tapir

要使 archicad-mcp 正常工作，需要安裝 Tapir Archicad 插件。請按照該倉庫中提供的安裝說明進行操作。

此軟件包還依賴兩個 Tapir 文件，它們定義了用於自動編譯 MCP 就緒工具的 JSON 命令結構：

• Tapir 命令定義文件
• Tapir 通用模式定義文件

這些文件位於 src/mcp_server/tapir 文件夾下。如果遇到命令不匹配的情況，請直接從 Tapir 倉庫更新這些文件。這些文件也可以直接從 Tapir 倉庫鏈接，但如果不同步更新插件，可能會導致不匹配。

FastMCP 服務器

1. 克隆倉庫

git clone https://github.com/lgradisar/archicad-mcp.git
cd archicad-mcp

2. 設置虛擬環境

建議使用 uv 來安裝和創建虛擬環境。

只需運行：

uv sync

3. 添加到 Claude 配置

手動編輯配置文件：

• 在 Windows 系統上：%APPDATA%\Claude\claude_desktop_config.json
• 在 Mac 系統上：~/Library/Application\ Support/Claude/claude_desktop_config.json

添加以下代碼塊（將 YOUR_DIRECTORY 替換為 archicad-mcp 的完整路徑）：

{
  "mcpServers": {
    "archicad-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "YOUR_DIRECTORY/archicad-mcp",
        "python",
        "-m",
        "server"
      ],
      "env": {
        "PYTHONPATH": "YOUR_DIRECTORY/archicad-mcp/src"
      }
    }
  }
}

✨ 主要特性

Tapir JSON 命令

查看完整的 Tapir JSON 命令列表。

自定義工具

此倉庫還支持添加自定義工具，這些工具可以來自 官方 JSON 命令 或其他來源。可以在 src/mcp_server/tools/custom_tools.py 文件中定義這些工具。

對於不屬於官方 JSON 命令的新 Archicad 特定命令，建議直接將其貢獻到 Tapir 倉庫。