Clarion Builder MCP Server

🚀 Clarion Builder MCP サーバー

Clarion の開発とビルド機能を提供する MCP サーバーです。このサーバーは、Clarion IDE の自動化操作、プロジェクトのコンパイル、およびビルド管理をサポートし、ClarionCL と MSBuild を使用します。

✨ 主な機能

• ClarionCL コマンドの実行
• プロジェクトの生成とコンパイル
• テンプレート管理
• 辞書のインポート/エクスポート
• TXA ファイルの処理
• MSBuild の統合
• 包括的なビルド構成

🛠️ ツール

ClarionCL 操作

clarion_cl

ClarionCL コマンドを実行して、IDE タスクを完了します。

• 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 エンタープライズ版"）
• conditionalGeneration: 生成操作で条件付き生成を有効にする
• debugGeneration: 生成操作でデバッグ生成を有効にする
• useWindowsIdentity: Windows 認証を使用する
• templateName: テンプレートの名前
• driverName: ドライバーの名前

ソリューションのビルド

compile_solution

ソリューションをコンパイルします。

• solutionPath: コンパイルするソリューションファイルのパス
• configuration: ソリューションの構成（例: "Debug" または "Release"）
• platform: ターゲットプラットフォーム（例: "Win32" または "x64"）
• generateMap: マップファイルの生成を有効にする
• vid: 仮想化モードを設定する（例: "full"、"none" または "media"）
• model: ビルドモデルを設定する（例: "Dll" または "Exe"）
• copyCoreFiles: コアファイルのコピーを有効にする

📦 インストール

1. Git を使用してリポジトリをクローンします。

git clone [Repository URL]

2. 依存関係をインストールします。

npm install

⚙️ 設定

以下の内容を MCP 設定ファイルに追加します。

{
  "servers": {
    "clarionBuilder": {
      "type": "ClarionBuilderMCP",
      "url": "http://localhost:3000"
    }
  }
}

💻 使用例

基本的な使用法

プロジェクトの生成

await mcp.use("clarion_builder", "generate_project", {
  solutionPath: "./MyApp.sln",
  configuration: "Debug",
  platform: "Win32"
});

TXA ファイルのインポート

await mcp.use("clarion_builder", "import_txa", {
  filePath: "./Resources/controls.txa",
  secondaryPath: "./Resources/l10n.xlsx"
});

ソリューションのコンパイル

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

👨‍💻 開発

1. ソースコードを変更します。
2. テストを実行します。

npm test

3. プロジェクトをビルドします。

npm run build

🤝 貢献

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. ブランチにプッシュします。
5. プルリクエストを作成します。

📄 ライセンス

MIT