surfcad

surfcad-agent

エージェントを自由に選べるSurfCADのスキルとヘルパーライブラリです。SurfCADは、カスタムManifoldカーネル上で動作するWeb CADアプリです。エージェントは任意のモデルを使用します。このリポジトリにAPIキーはなく、ホストされたモデルも呼び出しません。

プレリリース。 バージョン0.1.0には、ディレクトリ構成、同梱されたヘルパーランタイム、スキルが含まれます。packages/mcp-serverのMCPサーバーはプレースホルダーです（stdioプロセスは後のリビジョンで追加予定です）。server.jsonとレジストリへの公開フローは、このリビジョンには含まれません。このツリーからnpmに公開されるものはありません。

npmのsurfcadとnpmのsurfcad-mcpは、すでに0.0.1のプレースホルダー（「近日公開」）として存在します。このリポジトリのパッケージは0.1.0で、まだ公開されていません。プラグインの.mcp.jsonは[email protected]を指定していますが、そのバージョンが公開されるまでレジストリから解決できません。

ライセンス：Apache-2.0。

ディレクトリ構成

.claude-plugin/marketplace.json     marketplace name: surfcad-agent
plugins/surfcad/                    plugin name: surfcad (no bin/)
  .claude-plugin/plugin.json
  .mcp.json                         npx -y [email protected]
  skills/surfcad/SKILL.md           skill name: surfcad
  skills/surfcad/references/
packages/surfcad/                   npm surfcad, the helper library
  UPSTREAM                          pinned 3dculos SHA
  vendor/                           copy of that commit's sync-files.json list
packages/mcp-server/                npm surfcad-mcp, placeholder
scripts/sync-3dculos.mjs            re-vendor the pin
scripts/gen-references.mjs          regenerate four skill references

スキルフォルダーは1つです。.claude/skillsや.agents/skillsのコピーはありません。

ヘルパーライブラリ

packages/surfcadは、loadManifold、runScript、helperScope、およびSTL／3MF／STEPエクスポーターを再エクスポートします。wasmはvendor/built/manifold.wasmにあり、パッケージディレクトリを基準に解決されるため、プロセスの作業ディレクトリに依存せず、node_modules/surfcadから動作します。これは3dculosに同梱されているカスタムカーネルであり、npmのmanifold-3dではありません。

ピン留めにはpackages/surfcad/UPSTREAMに記載された完全なSHAを使用します。npm run syncは、そのコミットをGitHubからダウンロードし、sync-files.json内のすべてのruntimeFilesおよびcatalogFilesのパスを（パス構成を維持したまま）vendor/にコピーして、vendor/MANIFEST.jsonを書き込みます。CIでは同期を再実行し、ツリーに差分があれば失敗します。

npm test

このディレクトリから実行してください。ヘッドレステストでは、フィレット付きボックス、2ボディのアセンブリ、曲げたシートを作成し、ステータス、バウンディングボックス、体積、ボディ数、および空でないSTL、3MF、STEPを確認します。

スキルのインストール

エージェント	スキル	MCP
Claude Code	/plugin marketplace add artur0x0/surfcad-agent、続けて/plugin install surfcad@surfcad-agent	そのバージョンの公開後、プラグインの.mcp.jsonがnpx -y [email protected]を起動します。単独での設定：claude mcp add --transport stdio surfcad -- npx -y [email protected]
claude.ai / Cowork	Customize、Plugins、Add marketplaceでartur0x0/surfcad-agentを追加するか、plugins/surfcadフォルダーをアップロードします	ChatにはリモートHTTPサーバーが必要です。このリビジョンにはstdioの設定のみが含まれるため、Chatではツールを使わずスキルのみを利用できます
Claude API	plugins/surfcad/skills/surfcadをアップロードします（nameはフォルダー名と一致します）	—
Grok Build	このClaudeマーケットプレイスを読み込むか、npx skills add artur0x0/surfcad-agent -a grokを実行します	grok mcp add surfcad -- npx -y [email protected]
Hermes	hermes skills install artur0x0/surfcad-agent/plugins/surfcad/skills/surfcad	hermes mcp add surfcad --command npx --args -y [email protected]
その他のエージェント	npx skills add artur0x0/surfcad-agent	公開後のレジストリ名：io.github.artur0x0/surfcad

スキルのフロントマターはname、description、license、compatibility、metadata、allowed-toolsのみです。metadata.versionは文字列"0.1.0"です。