🚀 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 命令结构：
这些文件位于 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 仓库。