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 仓库。