PixInsight Connector

PixInsight Connector

あらゆる AI エージェントから PixInsight を操作できる MCP コネクターです。チャットセッションと、セッションを導くスキル向けに、約 80 種類の PixInsight 操作をツールとして提供します。初めての方は、クイックスタートをご覧ください。

コミュニティプロジェクトであり、Pleiades Astrophoto とは提携しておらず、同社の推奨を受けていません。PixInsight® は Pleiades Astrophoto S.L. の登録商標です。

基本方針：パイプラインではなく、ツールボックス

このコネクターが把握しているのは PixInsight の操作方法であり、良い画像を作る方法ではありません。パイプラインも、順序も、推奨値も、判定もありません。各ツールには画像を形作る値を入力し、測定結果は数値で返されます。どのツールをどんな順序でどの値とともに使うか、何をもって十分とするかといった知識は、スキル、つまり自分のパブリックまたはプライベートなリポジトリに置く Markdown に記述します。

%%{init: {'theme': 'base', 'flowchart': {'wrappingWidth': 400, 'curve': 'basis', 'padding': 18}, 'themeVariables': {'fontFamily': "-apple-system, BlinkMacSystemFont, 'Segoe UI', Inter, Helvetica, Arial, sans-serif", 'lineColor': '#94a3b8', 'textColor': '#334155', 'edgeLabelBackground': '#e2e8f0'}}}%%
flowchart TB
    classDef know fill:#0f766e,stroke:#115e59,color:#f0fdfa,stroke-width:1px,rx:12,ry:12
    classDef harness fill:#475569,stroke:#334155,color:#f8fafc,stroke-width:1px,rx:12,ry:12
    classDef tool fill:#1e293b,stroke:#64748b,color:#f8fafc,stroke-width:1px,rx:12,ry:12
    classDef app fill:#e2e8f0,stroke:#94a3b8,color:#0f172a,stroke-width:1px
    You(["You, in a chat session"]):::know
    Skills("<b>The knowledge · yours</b><br/>your skills: order, values, quality gates<br/>kept in your own repositories"):::know
    Harness("<b>Any MCP agent harness</b><br/>Claude Code · Codex · Cursor · Gemini CLI · …"):::harness
    Tools("<b>The toolbox · this connector</b><br/>~80 PixInsight operations as MCP tools<br/>measurements return numbers, never verdicts"):::tool
    Bridge("<b>File bridge + watcher script</b><br/>starts PixInsight on the first call"):::tool
    PI(["PixInsight 1.9.5+"]):::app
    You --> Harness
    Skills -. guides .-> Harness
    Harness -- MCP tool calls --> Tools
    Tools --> Bridge
    Bridge <--> PI
    linkStyle default stroke:#8b949e,stroke-width:1.5px

インストール

Node 22 以降と PixInsight 1.9.5 以降が必要です。自分で実行する場合も、エージェントに実行させる場合も、手順は同じ 3 つです。

1. コネクターをインストールします。npm からインストールしてください。

npm install -g pixinsight-connector

2. エージェントハーネスに MCP サーバー pixinsight として登録します。Claude Code の場合：

claude mcp add -s user pixinsight -- pixinsight-connector

mcpServers JSON ファイルで設定するハーネス（Cursor、Windsurf、Gemini CLI、Claude Desktop、Cline、Kiro）の場合：

{ "mcpServers": { "pixinsight": { "command": "pixinsight-connector" } } }

Codex、OpenCode、VS Code、Zed では別の形式を使います。各形式と設定ファイルの場所については、docs/setup.mdをご覧ください。

3. マシンを確認します。

pixinsight-connector doctor

PixInsight とその監視スクリプトは最初のツール呼び出し時に起動するため、それ以外に起動するものはありません。npm install -g pixinsight-connector@latest でアップグレードできます。インストールせずに使う場合は、コマンドとして npx -y pixinsight-connector を登録してください（npx は npm から取得するため、初回の起動にはネットワークが必要です）。pixinsight-mcp 1.x から移行する場合は、pixinsight エントリーの参照先を pixinsight-connector に変更し（別のサーバーを追加するのではありません）、npm uninstall -g pixinsight-mcp を実行してください。

ファイルの保存先

ツールはターゲットフォルダー内で動作します。ターゲットフォルダーは、set_workspace で指定したフォルダー、それ以外の場合は PIXINSIGHT_CONNECTOR_WORKSPACE が指定するフォルダー、さらにそれも指定されていない場合はハーネスの起動時フォルダーです。コネクターが書き込むのは <target>/agentic/（一時ファイル、ブリッジ、呼び出しログ）と <target>/output/ のみで、ホームフォルダーには書き込みません。詳細とすべての環境変数については、docs/setup.mdをご覧ください。

ツール、パック、スキル

• ツール： 78 種類。画像、プロセス、チャンネル、トーン、ディテール、マスク、星、ナローバンド、天体測定、測定、プレビュー、PJSR 実行、イントロスペクション、セッションに分類されています。全リストはdocs/tools.mdをご覧ください。
• スキルには技法を記述します。関連スキル（環境の事前確認、データセットの受け入れ、基本的な LRGB フロー）：pixinsight-connector-skills。
• パックは起動時にツールを追加または置き換える ES モジュールで、PIXINSIGHT_CONNECTOR_PACKS に指定します。パックはユーザー権限で実行される任意のコードです。読み込まれるのは自分で設定したパックのみです。CONTRIBUTING.mdをご覧ください。
• モデル： ビジョン機能と信頼性の高いツール呼び出し機能を備えたモデルなら、どれでも使えます。まず Sonnet クラスのモデル（Claude Sonnet 5、GPT-6 Sol、Gemini 3.8 Flash）から始め、その後、より低価格のモデル（GPT-6 Luna、GLM-5.3-Flash、DeepSeek V4.1 Flash）を試してください。料金と一覧はdocs/setup.mdにあります。

コントリビューション

まだツールがない PixInsight の機能を追加する場合は、レジストリーを変更せずに src/tools/ にモジュールを 1 つ追加してください：CONTRIBUTING.md。人間もエージェントも歓迎します。npm test の実行に PixInsight は必要ありません。

クロスプラットフォーム

このコネクターの実行と開発のどちらにおいても、macOS、Windows、Linuxを第一級のプラットフォームとして扱います。 あるOSでは動作して別のOSでは壊れる変更は、制限ではなくバグです。

• シェルのパイプラインは禁止です。 src/ または npm スクリプト内で ps、grep、awk、wc、df、&& を使わないでください。 OS固有の動作は src/platform.mjs（パス）または src/process-probe.mjs（プロセスの検査）の背後に置き、OSごとに実装を分けてください。
• POSIX形式のパスリテラルは禁止です。 path.join を使用してください。PixInsightはどのOSでもスラッシュを受け付けるため、パスをPixInsightに渡す場合に限り、スラッシュを使用してください。
• CIではLinux、macOS、Windowsで全テストを実行します。 1つのOSで成功しても、全体として成功したことにはなりません。
• 失敗させず、機能を縮退させてください。 メモリ使用量やプロセスの開始時刻など、任意の情報をOSから取得できない場合は、取得できなくても処理を続けてください。クラッシュとして報告しないでください。
• オーバーライドは常に優先されます。 実行ファイルには PIXINSIGHT_BIN、インストールルートには PIXINSIGHT_DIR を指定してください。

テストにはPixInsightも天文学ソフトウェアも必要ないため、3つのOSのどれでも開発できます。

トラブルシューティング

まず pixinsight-connector doctor を実行してください。よくある症状と対処法については、docs/troubleshooting.md を参照してください。

クレジットとライセンス

このプロジェクトは、Alain Escaffreによるaescaffre/pixinsight-mcpから始まりました。元のファイルブリッジとウォッチャースクリプトの一部が引き続き残っています。MITライセンスです。LICENSEを参照してください。