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 （通过捆绑包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 在项目根中。

1. 安装扩展：

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

或者手动输入VS代码：

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

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

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

1. 构建扩展：

   npm install
   npm run build

1. 按 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 资源管理器中的文件

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

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

1. 4D：启用MCP服务器

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

1. 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 .

备注

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

发展

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