Clarion Builder MCP Server

Clarion Builder MCP 服务

提供 Clarion 开发和构建功能的 MCP 服务。此服务使用 ClarionCL 和 MSBuild 实现 Clarion IDE 操作、项目编译和构建管理的自动化。

功能

• 执行 ClarionCL 命令
• 生成和编译项目
• 管理模板
• 导入/导出字典
• 处理 TXA 文件
• 集成 MSBuild
• 全面的构建配置

工具

ClarionCL 操作

clarion_cl

执行 IDE 任务所需的 ClarionCL 命令。

• action：要执行的 ClarionCL 操作（必需）
  • 可选值：
    • generate：生成项目文件
    • import-txa：导入 TXA 文件
    • export-txa：导出 TXA 文件
    • export-dict：导出字典
    • import-dict：导入字典
    • register-template：注册模板
    • unregister-template：取消注册模板
    • list-templates：列出已注册的模板
    • register-driver：注册驱动程序
• filePath：APP/SLN/TXA/DCT 文件的路径
• secondaryPath：用于导入/导出操作的次要路径
• version：要使用的 Clarion 版本（例如，“Clarion 11.0 Enterprise Edition”）
• conditionalGeneration：为 generate 操作启用条件生成
• debugGeneration：为 generate 操作启用调试生成
• useWindowsRedirection：使用 Windows 重定向文件（/win 开关）（必需）
• templateClass：模板操作所用的模板类名称
• redirectionFile：要使用的重定向文件（例如，“Clarion110.red”）（必需）

解决方案构建

compile_solution

使用 MSBuild 编译 Clarion 解决方案。

• solutionPath：.sln 文件的完整路径（必需）
• projectName：要编译的特定项目名称（例如，MyApp.app）
• targetName：要构建的特定目标/可执行文件名称（例如，MyApp.exe）
• configuration：构建配置
  • 可选值：'Debug' 或 'Release'
• platform：目标平台
  • 可选值：'Win32' 或 'x64'
• clarionBinPath：Clarion 二进制文件的路径
• logFile：构建日志文件的路径
• additionalArgs：其他 MSBuild 参数

构建选项：

• checkIndex：生成数组索引检查代码
• checkStack：生成堆栈访问检查代码
• lineNumbers：在 MAP 文件中添加行号
• generateMap：生成 MAP 文件
• stackSize：堆栈大小
• vid：调试支持级别
  • 可选值：'full'、'min'、'off'
• model：内存模型
  • 可选值：'Dll'、'Lib'、'CustomDll'
• copyCoreFiles：复制核心 DLL
• defines：以分号分隔的定义列表

要求

• Clarion 11.0 或更高版本
• Microsoft .NET Framework 4.0 或更高版本
• Visual Studio 构建工具
• Windows SDK

安装

1. 克隆仓库：

git clone https://github.com/yourusername/clarion-builder-mcp-server.git
cd clarion-builder-mcp-server

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

配置

将服务添加到 MCP 设置文件中：

{
  "mcpServers": {
    "clarion-builder": {
      "command": "node",
      "args": ["path/to/clarion-builder-mcp-server/dist/index.js"],
      "env": {}
    }
  }
}

使用示例

生成项目

await mcp.use("clarion-builder", "clarion_cl", {
  action: "generate",
  filePath: "./src/MyApp.app",
  version: "Clarion 11.0 Enterprise Edition",
  conditionalGeneration: true,
  useWindowsRedirection: true,
  redirectionFile: "Clarion110.red"
});

导入/导出 TXA

// Export TXA
await mcp.use("clarion-builder", "clarion_cl", {
  action: "export-txa",
  filePath: "./src/MyApp.app",
  secondaryPath: "./backup/MyApp.txa",
  useWindowsRedirection: true,
  redirectionFile: "Clarion110.red"
});

// Import TXA
await mcp.use("clarion-builder", "clarion_cl", {
  action: "import-txa",
  filePath: "./src/MyApp.app",
  secondaryPath: "./backup/MyApp.txa",
  useWindowsRedirection: true,
  redirectionFile: "Clarion110.red"
});

编译解决方案

await mcp.use("clarion-builder", "compile_solution", {
  solutionPath: "./MyApp.sln",
  configuration: "Release",
  platform: "Win32",
  generateMap: true,
  vid: "full",
  model: "Dll",
  copyCoreFiles: true
});

开发

1. 修改源代码
2. 运行测试：

npm test

3. 构建项目：

npm run build

贡献

1. Fork 仓库
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建 Pull Request

许可证

MIT