AI导哈

4D开发工具

一个MCP服务器和VS Code扩展，用于从AI助手或VS Code直接与4D IDE交互，支持打开4D项目和4D方法文件。

  • by mesopelagique
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 mesopelagique/4d-dev

使用说明

4D开发

MCP服务器和VS代码扩展 从您的AI助手或直接从VS Code与4D IDE交互。

它提供了以下工具：

  • 打开A .4DProject 4D
  • 打开一个或多个 .4dm 4D格式的文件

4D应用程序路径解析如下：

  1. 如果明确 appPath 参数已提供给工具，请使用它。
  2. 否则，如果 FOURD_APP 环境变量已设置，请使用它。
  3. 否则，在macOS上，尝试通过以下方式定位4D mdfind 使用CFBundleIdentifier com.4D.4D.
  4. 如果仍然没有找到，请返回 open -b com.4D.4D <file> （通过捆绑包id启动）。

注意：目前仅针对macOS。

安装

npm install
npm run build

用法

作为MCP服务器

典型的MCP客户端会将其作为stdio服务器启动。对于手动测试：

npm start

这将在stdio上启动服务器并等待客户端连接。

MCP工具

打开项目
  • 描述：在4D IDE中打开一个4D项目（.4DProject）。
  • 输入:
    • projectPath （string，必填）：指向的绝对或相对路径 .4DProject 文件
    • appPath （字符串，可选）：路径 4D.app如果省略， FOURD_APP 或 mdfind 发现被使用。

示例呼叫有效载荷（概念性）：

{
  "tool": "openProject",
  "params": { "projectPath": "/path/to/MyApp/Project/MyApp.4DProject" }
}
open方法
  • 描述：在4D IDE中打开一个或多个4D方法文件（.4dm）。
  • 输入:
    • methodPaths （string[]，必填）：一个或多个 .4dm 文件路径（绝对或相对）
    • appPath （字符串，可选）：路径 4D.app如果省略， FOURD_APP 或 mdfind 发现被使用。

示例呼叫有效载荷（概念性）：

{
  "tool": "openMethod",
  "params": { "methodPaths": ["Project/Sources/Methods/Foo.4dm", "Project/Sources/Methods/Bar.4dm"] }
}

作为VS代码扩展

安装

安装和使用扩展程序有三种方法：

选项1：安装预构建扩展

  1. 构建并打包扩展：

    npm install
npm run build
npm run package

    这创造了 4d-dev-0.1.0.vsix 在项目根中。

  2. 安装扩展：

    code --install-extension 4d-dev-0.1.0.vsix

    或者手动输入VS代码：

    • 打开VS代码
    • 转到扩展(Cmd+Shift+X)
    • 点击“…”菜单→ “从VSIX安装…”
    • 选择 4d-dev-0.1.0.vsix 文件

  3. 如果系统提示，请重新加载VS代码

选项2：开发模式（用于测试）

  1. 构建扩展：

    npm install
npm run build

  2. 按 F5 在VS Code中启动扩展开发主机进行测试。

选项3：发布到VS代码市场

（用于公开分发-需要VS Code发布者帐户）

npm run build
vsce publish

特性

该扩展提供了两个可通过命令面板使用的命令(Cmd+Shift+P 在macOS上）：

  1. 4D：在4D IDE中打开项目

    • 打开a .4DProject 4D IDE中的文件
    • 自动搜索工作区中的项目 Project/ 文件夹
    • 可以从以下位置调用：
      • 命令面板（自动发现项目）
      • 右键单击上下文菜单 .4DProject 资源管理器中的文件

  2. 4D：在4D IDE中打开当前文件

    • 打开当前 .4dm 或 .4DProject 4D IDE中的文件
    • 可以从以下位置调用：
      • 命令面板（使用活动编辑器）
      • 右键单击上下文菜单 .4dm 资源管理器或编辑器中的文件
      • 适用于打开或选择4D文件的任何地方

  3. 4D：启用MCP服务器

    • 自动注册MCP服务器以供AI助手使用
    • 配置Claude Desktop或其他MCP客户端以使用此扩展

  4. 4D：禁用MCP服务器

    • 从AI助手中注销MCP服务器

设置

通过VS代码设置配置扩展(Cmd+,):

  • 4d-dev.applicationPath：通往4D.app的路径（例如。， /Applications/4D v20 R6/4D.app)

    • 如果为空，扩展程序将通过Spotlight自动发现4D
    • 此设置由VS Code扩展和MCP服务器使用

  • 4d-dev.enableMcpServer：启用/禁用MCP服务器

    • 启用后，会自动向您的MCP客户端（例如Claude Desktop）注册此扩展
    • 该扩展将出现在您的AI助手的可用工具中
    • 违约： false

MCP服务器自动注册

此扩展可以自动注册为AI助手的MCP服务器：

  1. 打开VS代码设置(Cmd+,)
  2. 搜索“4D”
  3. 检查 “启用Mcp服务器”
  4. 可选设置 “应用程序路径” 到您的4D.app位置
  5. 重新启动MCP客户端（例如，Claude Desktop）

该扩展程序将自动配置您的MCP客户端以使用4D工具！

使用示例

打开4D项目：

  1. 打开命令选项板(Cmd+Shift+P)
  2. 类型“4D：开放式项目”
  3. 选择您的 .4DProject 文件
  4. 项目在4D IDE中打开

打开4D方法：

  1. 打开A .4dm VS代码文件
  2. 打开命令选项板(Cmd+Shift+P)
  3. 类型“4D：打开当前文件”
  4. 该方法在4D IDE中打开

或者简单地说：

  • 右键单击任何 .4dm 或 .4DProject 资源管理器中的文件
  • 从上下文菜单中选择相应的命令

环境

  • FOURD_APP （可选）：通往4D.app的绝对路径（例如。， /Applications/4D 20 R5/4D.app).如果设置，则跳过发现。

发现详细信息

当否 appPath 论证通过 FOURD_APP 如果未定义，服务器/扩展将执行：

mdfind "kMDItemCFBundleIdentifier == 'com.4D.4D'"

第一 .app 结果如下 /Applications 是首选。 如果找不到任何东西，则返回到 open -b com.4D.4D <file>.

备注

  • 这使用macOS open 以4D格式启动文件。
  • .4DProject 文件可靠地打开相应的项目。
  • .4dm 文件根据应用程序的Info.plist注册到4D，应在4D IDE中打开。
  • 非macOS平台目前会抛出描述性错误。

发展

  • 构建: npm run build
  • 观看模式: npm run dev
  • 类型检查: npm run typecheck
  • 包扩展: npm run package

相关 MCP