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：インポート／エクスポート操作用の第 2 パス
• 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：セミコロン区切りの define リスト

要件

• 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. リポジトリをフォークします
2. フィーチャーブランチを作成します
3. 変更をコミットします
4. ブランチにプッシュします
5. Pull Request を作成します

ライセンス

MIT