适合谁
- 使用 GeneXus 18 的开发者和团队
- 希望通过自然语言操作知识库的 AI 工具用户
G
FMRS 60/100 · C — 查看 FMRS 评分方法 →
GeneXus MCP 服务器使 AI 代理（如 Claude Desktop、Claude Code、Cursor 等）能够通过 MCP 协议读取、编辑、分析和重构 GeneXus 18 知识库中的对象。该工具原生集成 GeneXus SDK，确保代理处理的是真实的知识库而非副本。支持数据模型创作、索引管理、WorkWithPlus 界面编辑、代码重构、构建、测试、部署、版本控制等功能。
工具能力
genexus_whoami
获取知识库上下文、版本和运行状况。
genexus_doctor
检查连接和安装健康。
genexus_recipe
执行命名操作手册和宏。
genexus_telemetry
收集可观测性指标。
genexus_query
搜索对象（支持前缀过滤）。
genexus_list_objects
分页列出对象及聚合信息。
genexus_read
读取对象任意部分（源码、结构等）。
genexus_inspect
一次性获取对象快照（元数据、变量等）。
genexus_search_source
使用正则表达式搜索源码。
genexus_navigation
获取导航报告。
genexus_edit
编辑对象任意部分（全量、补丁或操作模式）。
genexus_edit_and_build
编辑并编译，失败自动回滚。
genexus_edit_form
语义化编辑 WebForm。
genexus_variable
增删改查变量。
genexus_create
创建各种对象（事务、过程、域等）。
genexus_delete_object
删除对象。
genexus_format
使用规则格式化代码片段。
genexus_structure
读写数据模型结构（含索引创建）。
genexus_authoring
管理外部对象和菜单选项。
genexus_properties
读写对象属性。
genexus_refactor
重构（重命名、提取过程）。
genexus_apply_pattern
应用模式（WorkWith、WorkWithPlus）。
genexus_wwp
管理 WorkWithPlus 操作和按钮。
genexus_compare
比较对象（类似 IDE）。
genexus_merge
合并对象（支持三方合并）。
genexus_analyze
语义分析（影响、依赖、复杂度）。
genexus_doc
生成文档和图表。
genexus_api
检查 REST API 端点。
genexus_security
进行安全审计和扫描。
genexus_lifecycle
构建、校验、索引等生命周期操作。
genexus_test
运行 GXtest 测试。
genexus_db
数据库操作（DDL、索引建议等）。
genexus_deploy
部署应用。
genexus_run_object
解析运行时 URL。
genexus_browser
无头浏览器验证。
genexus_layout
布局/WebForm 操作。
genexus_kb
管理多个知识库（打开、关闭等）。
genexus_module
模块管理器。
genexus_kb_version
知识库版本管理。
genexus_versioning
版本控制（类似 git 历史）。
genexus_gxserver
GXserver 同步和 CI 流水线。
genexus_transfer
XPZ 导入导出。
genexus_memory
知识库事实存储。
genexus_gam
GAM 安全配置。
genexus_io
资产、截图、OCR。
genexus_sdk_probe
检查 SDK 表面。
genexus_worker_reload
热重载工作进程。
安装接入
- 确保 Windows、GeneXus 18 已安装且知识库已初始化。
- 运行
npx genexus-mcp@latest init --kb "<知识库路径>" --gx "<GeneXus安装路径>"。 - 重启 AI 客户端（完全关闭进程）。
- 输入测试提示，如"使用 GeneXus MCP 列出前 5 个对象"。
选型与风险
不适合谁
- 非 GeneXus 用户
- 需要跨平台支持（仅限 Windows）
- 希望无需本地安装即可使用的用户
所需权限
- 读写本地文件系统（知识库文件）
- 执行构建、部署等进程操作
- 网络访问（用于 CI 等）
风险与副作用
- 错误使用编辑工具可能导致知识库损坏，但有回滚机制
- 构建过程可能带来性能开销
- 需要授予进程充分的执行权限
常见排障
- 常见问题包括：
- - 客户端未检测到工具：检查客户端配置和运行 `npx genexus-mcp clients`。
- - 工作进程启动失败：查看 .NET 4.8 错误。
- - 构建错误：常见于文件锁定，检查 KB 构建日志。
- - 端口冲突：如果 5000 端口被占用，修改配置。
使用场景
AI 辅助查看和编辑 GeneXus 对象
自动化数据模型创作
执行构建和测试
重构和版本管理
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Cursor完整支持
Antigravity完整支持
Gemini CLI完整支持
OpenCode完整支持
Codex CLI完整支持
VS Code完整支持
VS Code Insiders完整支持