mcp-1c-platform-tools

1C: Platform Tools MCP

MCP サーバーを使うと、VS Code または Cursor のエージェントから、コンフィギュレーター、1C:EDT、OneScript のプロジェクトで 1C: Platform Tools 拡張機能のコマンド（テスト、実行プロファイル、コンフィギュレーションのビルド、データベース操作）を利用できます。

インストール

1. 1C: Platform Tools をインストールします：Marketplace、Open VSX
2. 1C: Platform Tools MCP をインストールします：Marketplace、Open VSX
3. 1С プロジェクト（packagedef を含むフォルダー）を開きます。

接続

VS Code では追加の設定は不要です。拡張機能が MCP サーバーを自動で登録します。

Cursor は VS Code の MCP サーバープロバイダーに対応していないため、プロジェクトの .cursor/mcp.json を使ってサーバーを接続します。このファイルは拡張機能が作成・更新します。

1. コマンドパレット（F1）→ 1C: Platform Tools MCP: Настроить MCP для Cursor、またはツリーの Инструменты 1С → Навыки для AI → Настроить MCP для Cursor を選択します。
2. ウィンドウを再読み込みします。
3. MCP 設定で mcp-1c-platform-tools サーバーを有効にします。Cursor で新しく追加されたサーバーは無効になっています。

このコマンドはサーバーへのパスと IPC パラメーターを書き込みます。ファイル内のほかのサーバー設定は保持されます。パスには拡張機能のバージョンが含まれるため、更新後は設定が古くなり、サーバーが MODULE_NOT_FOUND で停止します。拡張機能は起動時にこれを修正し、同じ拡張機能の別のインストール先を参照している場合はパスを更新します。手動で指定したパス（ソースからのビルド先など）はそのまま維持されます。

確認

エージェントに「1С 環境の状態を表示して」と入力します。実行プロファイル、プラットフォームのバージョン、データベースへのパスが表示されます。その後、テストの実行、プロファイルの切り替え、コンフィギュレーションのビルドを依頼できます。

ドキュメント

docs ディレクトリは、1C: Platform Tools サイトの MCP サーバー セクションで公開されています：インストールと接続、ツールのパラメーター、エージェントへの依頼例。

手動設定

拡張機能を使わずに設定する場合のみ必要です。1c-platform-tools.ipc.enabled 設定を有効にし、ONEC_IPC_* の値には 1c-platform-tools.ipc.* の値を指定します。

{
  "mcpServers": {
    "mcp-1c-platform-tools": {
      "command": "node",
      "args": ["<путь к каталогу расширения>/out/src/index.js"],
      "env": {
        "ONEC_IPC_HOST": "127.0.0.1",
        "ONEC_IPC_PORT": "40241",
        "ONEC_IPC_TOKEN": ""
      }
    }
  }
}

拡張機能のディレクトリ：%USERPROFILE%\.cursor\extensions\yellow-hammer.mcp-1c-platform-tools-<версия>-universal（Windows）または ~/.cursor/extensions/...（macOS、Linux）。拡張機能を更新するたびに、このパスを手動で修正する必要があります。

グローバル設定（%USERPROFILE%\.cursor\mcp.json）も同じように機能しますが、拡張機能による更新は行われません。複数のプロジェクトで使う場合は、プロジェクト単位のファイルのほうが確実です。