IFC MCP

ChatGPT 桌面应用支持通过 STDIO 使用本地 MCP 服务。

1. 打开 ChatGPT 桌面应用。
2. 打开 Settings。
3. 选择 Plugins，然后选择 MCPs。
4. 点击 Add。如果系统提示选择服务类型，请选择 STDIO。
5. 输入：
   • 名称：ifc-mcp
   • 启动命令：npx
   • 第一个参数：-y
   • 第二个参数：ifc-mcp
6. 将环境变量字段留空并保存服务。
7. 重启 ChatGPT 桌面应用。
8. 开始新的聊天，输入 /mcp，并确认 ifc-mcp 已连接。

如需了解更多信息，请参阅 OpenAI 的 MCP 文档。

选项 1：使用 Claude Desktop 界面

1. 打开 Claude Desktop。
2. 打开 Settings。
3. 打开 Developer 或 Desktop app 开发者设置。
4. 如果有 Edit Config 按钮，请点击它。这会打开 Claude Desktop MCP 配置文件。
5. 粘贴以下 JSON，保存文件，然后完全退出并重新打开 Claude Desktop。

{
  "mcpServers": {
    "ifc-mcp": {
      "command": "npx",
      "args": ["-y", "ifc-mcp"]
    }
  }
}

如果文件中已有 JSON，请仅将 ifc-mcp 条目添加到现有的 mcpServers 对象中。不要创建第二个 mcpServers 对象。

选项 2：直接打开配置文件

仅当你在 Claude Desktop 中看不到 Edit Config 时使用此选项：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

粘贴与选项 1 相同的 JSON，保存文件，然后完全退出并重新打开 Claude Desktop。

检查

要检查设置，请打开 Claude Desktop，开始新的聊天，点击聊天框旁的 + 按钮，然后查找 Connectors。Claude Desktop 重启后，IFC MCP 应会显示在那里。你应该能看到上方 工作原理 部分中列出的工具。

选项 1：使用安装按钮

此操作会打开 VS Code 并添加 IFC MCP。

如果 VS Code 询问你是否信任该服务，请选择接受。如果工具没有显示，请重新加载 VS Code。打开聊天，并使用工具/配置工具按钮查看 IFC MCP 工具。

选项 2：手动添加 .vscode/mcp.json

{
  "servers": {
    "IFC MCP": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "ifc-mcp"]
    }
  }
}

保存文件后，重新加载 VS Code。

打开聊天，并使用工具/配置工具按钮查看 IFC MCP 工具。

有关详情，请参阅 VS Code MCP 服务文档。

选项 1：使用 Codex 设置界面

1. 打开 VS Code。
2. 打开 Codex 面板。
3. 打开 Codex 设置。
4. 选择 MCP servers。
5. 点击 Add server。
6. 输入：
   • 名称：ifc-mcp
   • 命令：npx
   • 参数：-y ifc-mcp
7. 保存服务。
8. 重新加载 VS Code 或启动新的 Codex 会话。
9. 检查 IFC MCP 工具是否在新的 Codex 会话中可用。

选项 2：使用终端命令

1. 在 VS Code 中打开 Terminal -> New Terminal。
2. 粘贴并运行：

codex mcp add ifc-mcp -- npx -y ifc-mcp

3. 重新加载 VS Code 或启动新的 Codex 会话。
4. 检查 IFC MCP 工具是否在新的 Codex 会话中可用。

有关详情，请参阅 Codex MCP 文档。

选项 1：使用项目 JSON 文件

1. 在 VS Code 中打开你的项目。
2. 在项目根目录中创建或编辑 .mcp.json。
3. 添加以下 JSON 并保存文件：

{
  "mcpServers": {
    "ifc-mcp": {
      "command": "npx",
      "args": ["-y", "ifc-mcp"]
    }
  }
}

4. 在 VS Code 中重新打开 Claude Code。
5. 输入 /mcp，如果 Claude 询问，请批准项目服务。
6. 检查 ifc-mcp 是否已连接。

选项 2：使用适用于所有项目的终端命令

claude mcp add --transport stdio ifc-mcp --scope user -- npx -y ifc-mcp

然后在 VS Code 中重新打开 Claude Code，输入 /mcp，并检查 ifc-mcp 是否已连接。

如果找不到 claude 命令，请先安装 Claude Code。

有关详情，请参阅 Claude Code VS Code 文档和 Claude Code MCP 文档。

将此服务条目添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "ifc-mcp": {
      "command": "npx",
      "args": ["-y", "ifc-mcp"]
    }
  }
}

保存配置后，重启 MCP 客户端。

有关详情，请参阅 Model Context Protocol 文档。

提供接收本地文件路径的处理程序。将下面的函数替换为你的应用的查看器操作：

import { createServer } from "ifc-mcp";
import { serveStdio } from "@modelcontextprotocol/server/stdio";

serveStdio(() => createServer({
  viewer: {
    "open-ifc-viewer": () => openThisViewer(),
    "show-ifc-file": ({ file_path }) => loadIfcIntoThisViewer(file_path),
    "set-bcf-view": ({ bcf_path }) => applyBcfToThisViewer(bcf_path),
    "clear-ifc-viewer": () => clearThisViewer(),
  },
}));

从处理程序返回 MCP 工具结果：content 包含反馈，isError: true 表示失败。

传入在应用中选择的文件，以及现有查看器的回调。此处，file 是选中的 IFC File，viewer 是你的查看器实例：

import { createIfcMcpHost } from "ifc-mcp/browser";

const files = new Map([
  [file.name, { name: file.name, source: file }],
]);

const host = createIfcMcpHost({
  files,
  viewer: {
    "show-ifc-file": (name, bytes) => viewer.add(name, bytes),
    "set-bcf-view": (name, bytes) => viewer.add(name, bytes),
    "clear-ifc-viewer": () => viewer.clear(),
  },
});

const result = await host.handleToolCall({
  name: "show-ifc-file",
  input: { file_path: file.name },
});

文件回调会接收文件名和 Uint8Array 字节。BCF 回调必须返回 MCP 工具结果，说明视点是否已应用。使用 host.tools 获取工具定义，并使用 host.getGeneratedFiles() 获取生成的下载文件。不再需要这些下载文件时，调用 host.clearFiles()。