Genexus MCP Server Guide

GeneXus MCP服务器指南

此存储库收集有关使用的知识 GeneXus MCP Server重点关注已经确认的和尚未验证的内容。

初始来源

• GeneXus for Agent-安装指南

本文档的范围

此材料是场景的一部分 Windows Native官方安装指南的重点。

目标

• 记录服务器设置
• 记录机器上的确切位置
• 将观测、验证和未来发现集中在一个地方
• 了解如何在开放 IDE 的情况下使用 MCP

已知组织

这个资料库是知识库。 GeneXus MCP Server.

有一个单独的本地工作区，用于测试和研究文物。 C:\Dev\Test.

这份文件记录了我们已经理解的和尚未确认的现状。

实践规则 ：

• 这里是注释，决定和解释 .md
• 来自 KB 的内容、导出的内容和准备导入的内容都保存在本地测试工作区中
• 研究文物不得与永久文件混合

初始定义

哦 GeneXus MCP Server 是本地后端 GeneXus Next 与工具和代理集成。在经过验证的安装中，它由可执行文件提供服务 GeneXus.Services.Host.exe.

Model Context Protocol (MCP) 是允许代理连接到暴露受控操作的服务器的协议。

官方指南确认服务器：

• 已经包含在 GeneXus Next
• IDE 运行时可用
• 也可以直接从文件夹中运行 bl
• 可从 GeneXus Next 2026.01 e GeneXus 18 Upgrade 15
• 允许，除其他操作外，创建和打开 Knowledge Bases创建或修改对象，定义 rules配置属性并导入或导出文本对象

驱动器上的位置

服务器保存在文件夹中 bl 的 安装 GeneXus Next.

已确认的可执行文件是 GeneXus.Services.Host.exe.

在此计算机上经过验证的安装中， 主机的绝对路径是 ：

C:\Users\ANTONIOJOSE\AppData\Local\Programs\GeneXus\GeneXus Next\bl\GeneXus.Services.Host.exe

支持文件

根据官方指南，跟踪最相关的本地文件是：

• GXMBLServices.log监控后端的运行和交互
• settings.json默认创建于 bl
• settings-overrides.json覆盖设置而不更改默认文件

与 CLI 的连接

官方指南显示服务器暴露端点 http://localhost:8001/mcp 并且可以连接到MCP兼容的CLI。

如何启动服务器

这里的重点是使用 GeneXus MCP Server 不依赖于开放的IDE，也不排除混合使用。

根据官方指南，有两种有用的方式：

• 启动 IDE，它会自动上传服务器
• 只启动本地后端， 运行 GeneXus.Services.Host.exe 从文件夹 bl

推荐的操作流程

1. 打开安装 GeneXus Next.
2. 进入文件夹 bl.
3. 执行 GeneXus.Services.Host.exe.
4. 确认服务器在默认端点上响应 。

已验证的本地快捷方式

在此机器上， 启动菜单中已经存在仅上传主机的快捷方式 ：

• GENEXUS MCP正常打开主机
• GENEXUS MCP MIN打开最小化的主机

这些快捷方式出现在Windows搜索中，并指向 GeneXus.Services.Host.exe.

启动时预期的行为

通过快捷键打开主机或运行 .exe 直接，预计会出现一个终端窗口。

正确启动的相关信号是：

• GeneXus Services Host started. port:8001
• Now listening on: http://localhost:8001
• Application started. Press Ctrl+C to shut down.

窗口显示包和消息加载日志也是正常的 404 OAuth Discovery 的辅助端点。

服务器使用期间窗口必须保持打开 。

如何验证它是否处于活动状态

验证的实用方法是确认 MCP 端点响应：

http://localhost:8001/mcp

观察也是有意义的。 GXMBLServices.log因为它记录了后端的运行和交互。

实际验证标准

• 主机进程正在运行
• o终点 http://localhost:8001/mcp 回答
• 哦 GXMBLServices.log 显示没有装入错误的启动
• CLI 无法连接到 MCP 服务器

实际 MCP 验证

端点没有响应 GET 简单。他正在等待一个MCP客户端 Accept: application/json, text/event-stream. 使用脚本时，请注意：响应可能以前缀到达SSE event: e data:. 提取行 data: 解析其中包含的JSON。

在验证过程中 ：

• initialize 已成功回复
• 服务器返回 Mcp-Session-Id
• tools/list 返回暴露的 GeneXus 工具

这确认服务器作为MCP运行，而不仅仅是监听端口。

与工作时 Knowledge Bases请注意，打开的 KB 与运行 KB 的 MCP 会话相关联。 open_knowledge_base.

实际上，这意味着在一个会话中打开 KB 并不能保证另一个 MCP 会话已经看到同样的打开状态。

如何注册非Codex Windows

本地编解码器支持用户配置文件中的外部 MCP 服务器。 此服务器的日志使用别名 gxnext.

codex mcp add gxnext --url http://localhost:8001/mcp

日常使用

使用的最小流量 GeneXus MCP Server:

1. 主持人 GeneXus.Services.Host.exe.
2. 确认门 8001 它是开放的。
3. 确认 MCP 握手 initialize.
4. 使用 Codex 服务器作为 gxnext.

环境提示： 在 Windows 中的本地脚本中， use python3 只要可用。命令 python 可能指向 Python 2 并导致语法或编码错误。

Se o initialize 失败于 406问题通常是 Accept 请求，而不一定是服务器关闭。

在列表操作中， export_kb_to_text com listOnly:true 可以在不返回 MCP 有效负载中的对象列表的情况下成功完成。

当需要获取实际对象列表时，可能需要将 KB 导出到工作文件系统并读取生成的文物。

当前状态

• 哦 GeneXus MCP Server 可以回答在 http://localhost:8001/mcp
• 本地主机是 GeneXus.Services.Host.exe
• 此机器上有效的主机绝对路径是 C:\Users\ANTONIOJOSE\AppData\Local\Programs\GeneXus\GeneXus Next\bl\GeneXus.Services.Host.exe
• 服务器可以在不打开 IDE 的情况下启动
• 有用于正常和最小化主机打开的本地快捷方式
• 相关日志是 GXMBLServices.log
• settings.json e settings-overrides.json 是当地支持的一部分

工作期限

Arquivo Textual de Objeto Genexus 意味着一个文件 .gx 它以文本形式表示一个 GeneXus 对象，可以作为读取、研究、导出或导入 MCP 流的源。

工作区测试

用于生成和导出文物的本地工作空间是 C:\Dev\Test\NextTest1这是官方文件夹 currentDirectory 适用于所有 KB 的 MCP 操作 NextTest1.

内部结构：

已验证的构建流程

已验证的 KB 的完整流 Transaction 新是 ：

1. open_knowledge_base com currentDirectory 指向测试工作区
2. import_text_to_kb 与文件 .gx 准备好了
3. build_all --请求者 prefer-offline=true e audit=false 不 ~/.npmrc
4. 在任何银行操作之前检查应用程序银行是否已经存在于 LocalDB 中
5. create_or_impact_database com isCreate: false 如果银行有数据， isCreate: true 如果不存在
6. 通过上传应用程序 dotnet GxNetCoreStartup.dll 意大利面 NetModel\web\bin

npm install 特拉万多建筑

哦 build_all 茶马 npm install GeneXusUnanimo 的 UserControls。如果没有正确的配置，这个过程将无限期地停止。

已验证的解决方案： 添加到 ~/.npmrc:

prefer-offline=true

正在评估： audit=false 它还解决了但禁用了全球安全检查。尚未确认是否 prefer-offline=true 单靠它就足够了 - 在下一个构建中验证。

打开的点

• 工具 run MCP 在此版本中不可用 - 在架构中声明但未实现。查看 mcp-tools.md 细节和替代。
• 确认 prefer-offline=true 独自在 ~/.npmrc 这足以避免悬挂 npm install 不 build_all （在下一个构建中观察）
• Procedure nova通过MCP-- PrcSaudacao 已成功导入并且在 KB 中， 但未生成 .dll 持续时间 build_all可能的时间问题（在规范处理新对象之前运行的构建）或真正的错误。请求新的 build_all 验证是否在下次运行时编译。

校验完成

• 往返de WebPanel 通过 MCP: export → 编辑 .layout.xml → import → build → 在浏览器中可见的结果✅
• textblock 无布局要求 controlName 除了 name 没有它，导入失败。✅
• 在构建之前关闭 Web 应用程序 — 安全进程 .dll 嗯 NetModel\web\bin\ ✅
• Folder 是可通过创建的 GeneXus 对象类型 import_text_to_kb 带空主体文件✅
• 通过 MCP 在文件夹之间移动对象不起作用 Folder 嗯 #Properties不通过子目录；IDE 独家✅
• MCP没有 delete_object 导入的对象无法通过 MCP 删除✅
• WorkWith e WorkWithDevices 可通过MCP出口，但 不可重新导入验证器拒绝YAML中的标签，即使是在GeneXus自己生成的文件中；独家创建和编辑 IDE✅
• BusinessComponent = true 嗯 #Properties 要求小写（TOML）- True 大写引起解析错误✅
• &bc.Load(Key) 需要 PK 作为参数 — Load() 无参数不被验证器接受✅
• WorkWithWeb 生成的往返对象 （WWxxx, ViewXxx, XxxGeneral)--圣 WebPanel/WebComponent 常见的，并支持标准流： 出口 → 编辑 .layout.xml → 验证→ 导入→ 构建→ visível无浏览器✅
• 循环跳闸码 .main.gx （不仅仅是布局） — 在 WebPanel 中编辑事件/规则的工作原理： Form.Caption 在事件开始中更改，导入，编译，更改反映在浏览器中✅
• execute.xml 它可以被锁定后 build_allGeneXus报告了一般故障，但该步骤 dotnet publish 已经发生，DLLs 在 bin\ 已更新 - 应用程序正确地服务于更改✅
• GeneXus Daemons(SpecifierDaemon, GeneratorDaemon, ResidentBuilderDaemon关闭 IDE 后成为孤儿，并通过 MCP 阻止构建；解决方案： 列出 Get-WmiObject Win32_Process 并用杀死 PID Stop-Process -Force 在下一个构建之前✅
• WebPanel 通过 MCP 从头创建的新文件 .webpanel.main.gx 以最少的事件/变量编译和生成功能性DLL✅
• build_one e compile_object — 无法工作 此版本的 GeneXus；两者都返回没有详细信息的“内部错误”；使用 build_all 作为一种选择❌