3DOptix

AI コーディングエージェント向け 3DOptix

3DOptix のクラウドプラットフォームを使って、コーディングエージェントから光学システムを設計、シミュレーション、解析できます。

このリポジトリはプラグインです。3DOptix MCP サーバーと、エージェントがうまく活用できるようにするスキルをまとめています。一度インストールすれば、エージェントで光学セットアップの構築、レンズや検出器の配置、GPU による光線追跡シミュレーションや高度な光学解析を実行できます。

ここにあるスキルは、Agent Skills のオープン標準に準拠しているため、Claude Code、Codex、Cursor など、準拠しているクライアントで動作します。

---

インストール

Claude Code

claude plugin marketplace add 3doptix/skills
claude plugin install 3doptix@3doptix

Codex

codex plugin marketplace add 3doptix/skills
codex plugin add 3doptix@3doptix

MCP サーバーのみ

ワークフローのガイダンスは不要で、ツールのみを利用したい場合は、サーバーがMCP Registry に com.3doptix/optical-design として登録されています。または、直接追加できます。

claude mcp add --transport http 3doptix https://mcp.3doptix.com

アカウントを接続する

3DOptix のアカウントが必要です。3doptix.com で新規登録すると、すべての機能を利用できるトライアルが始まります。継続して利用するにはサブスクリプションが必要です。

認証には動的クライアント登録を用いた OAuth 2.0 を使用します。貼り付ける API キーはありません。

• Claude Code — /mcp を実行し、3doptix を選んで、ブラウザーからサインインします。
• Codex — codex mcp login 3doptix を実行します。

その後、セットアップの一覧表示をエージェントに依頼し、接続できたことを確認してください。エージェント自身に手順を案内してもらうこともできます。接続エラーが発生すると、同梱の 3doptix-setup スキルが有効になります。トラブルシューティングの詳細は、skills/3doptix-setup/SKILL.md を参照してください。

---

内容

スキル	対応内容
3doptix-workflow	セットアップの作成、コンポーネントの配置と調整、光源、検出器、カタログおよびカスタム光学部品、シミュレーション、解析、最適化、Zemax のインポート、CAD のアップロード
3doptix-setup	MCP サーバーの接続と確認。認証エラー時に有効化

3doptix MCP サーバーは、セットアップ、部品、光学およびオプトメカニクスのカタログ、シミュレーション、解析、レンダリングのツールを提供します。ツールのリファレンスは 3doptix.com を参照してください。

試してみる

Build a 2-lens beam expander for a 5 mm 632 nm beam, 3× magnification,
then run a spot diagram on the output.

Import my Zemax file into 3DOptix and tell me where the aberrations are worst.

---

リポジトリの構成

.claude-plugin/     Claude Code plugin + marketplace manifests
.codex-plugin/      Codex plugin manifest
.agents/plugins/    Codex marketplace manifest
.mcp.json           The 3DOptix remote MCP server
server.json         MCP Registry entry
skills/             Agent Skills — shared by every store
assets/             Store icons (the spectral sphere from the 3DOptix mark)
scripts/            validate.js, set-version.js — plain Node, no dependencies

スキルの内容は1か所にだけ配置されています。各ストアには、同じ skills/ ツリーを参照する小さなマニフェストを用意しているため、クライアントごとに内容が重複することはありません。

ビルド手順はありません。スキルは Markdown、マニフェストは JSON なので、ここにある内容がそのままインストールされます。

---

コントリビューション

スキルの追加

必要なフロントマターを含む skills/<name>/SKILL.md を作成します。

---
name: your-skill-name
description: "When this skill should and should not trigger."
---

name はディレクトリ名と一致させてください。すべてのストアでこの条件が検証されます。遅延読み込みする内容は skills/<name>/references/ に配置し、SKILL.md から参照してください。スキルはディレクトリ単位で検出されるため、新しいスキルを登録するマニフェストはありません。

公開されるのは skills/ の下にあるスキルだけです。開発中のスキルは、代わりに inactive-skills/ ディレクトリに配置してください。各ストアはこのディレクトリをスキャンしないため、ユーザーに届くことなくリポジトリに置いておけます。

チェック

node scripts/validate.js

インストールは不要で、依存関係もありません。Agent Skills 仕様に照らしてスキルのフロントマターを検証し、4つすべてのマニフェストでバージョンが一致していることを確認します。また、.mcp.json に認証情報が追加された場合はチェックに失敗します。CI ではプッシュやプルリクエストのたびに同じスクリプトを実行します。

変更を公開する前に、ユーザーが実際に受け取る内容も確認してください。

claude plugin details 3doptix

リリース

.claude-plugin/plugin.json に正式なバージョンが記載されています。リリースを作成する手順は次のとおりです。

node scripts/set-version.js 1.1.0   # writes all four manifests
node scripts/validate.js
git commit -am "release: 1.1.0" && git tag v1.1.0
git push && git push --tags

マニフェストの version を手作業で編集しないでください。 validate.js が失敗します。それが意図した動作です。

このプラグインを掲載しているディレクトリは main のコミットを追跡し、変更を自動的に取り込みます。そのため、タグ付けの有無にかかわらず、プッシュすればリリースになります。それでもタグを付けてください。ユーザーが動作確認済みのバージョンを指定するために使います。

---

サポート

• 製品とアカウント — [email protected]
• これらのスキルのバグ — このリポジトリで Issue を作成してください
• プライバシー — プライバシーポリシー

ライセンス

MIT — LICENSEをご覧ください。