Magist

@magist/mcp-server

Magist を Model Context Protocol 経由で AI ホストに接続します。Magist は、製品規制に関するオープンで決定論的なリファレンスです。製品にどの法律が適用されるか、それらがどのような義務とコントロールをもたらすか、そしてそれぞれの根拠となる一次資料を示します。オープンデータ（CC BY-SA 4.0）、決定論的なエンジン（同じ入力からは同じ出力が生成され、処理に LLM は介在しません）、永続的な引用 URL、すべての応答における実名の実務家による出典表示を備えています。

このパッケージは、ホストされたサーバー https://magist.io/api/mcp への薄いstdio ブリッジです。リモート接続に対応したホストでは、このブリッジを省略して URL に直接接続できます。

オフラインでのレシート整合性

独立したreceipt-v9 コンテンツ整合性ユーティリティは、Node の組み込み機能のみを使って、保存された JSON 本文のハッシュを検証します。ネットワーク接続は行わず、エンジンの実行や送信者の認証も行いません。合成テストとソースコードは、公開済みのブリッジおよびプラグインペイロードとは分離されています。

リサーチプラグインパッケージ（実験的プレビュー）

このリポジトリには、独立したポータブルプラグイン magist-research 0.1.1 も含まれています。ルートの plugin.json、mcp.json に記述されたリモート接続、新たに作成された skills/magist-research/ のワークフローで構成されています。このプラグインは公開 HTTPS サービスに直接接続し、npm の stdio ブリッジは実行しません。

ポータブル接続では、Agent Plugins 1.0.0 MCP スキーマで許可されている type と url のみを使用します。エンドポイントに認証は不要です。このスキーマでは、一部のホスト固有の例に示されているサーバーレベルの認証拡張は認められていないため、ここではそれらの拡張を省略しています。スキーマ検証だけでは、ホストがプラグイン全体をインストールして実行できることは確認できません。

Python 3.9 以降を使って、依存範囲を限定したソースパッケージを作成します。

python3 scripts/package-plugin.py --output /absolute/new/path/magist-research-0.1.1.zip

ZIP には、2 つのポータブルマニフェスト、スキルとその MCP 依存関係の宣言、既存の公開 Magist アイコン、このリポジトリの MIT ライセンスが含まれます。ブリッジの実行ファイル、依存関係、非公開のプラットフォームソースおよびアセットは含まれません。プラグインのバージョンは @magist/[email protected] とは独立しています。

これは提案中の統合パッケージであり、ディレクトリへの掲載が承認されたことや、ホストでの検証が完了したことを証明するものではありません。一般公開への申請には、OpenAI のWith MCP 申請方法を使用します。パブリッシャーの検証、実際のホストやレビュアーによるテストケース、メディア、必要なビジュアルアセット、接続確認、申請審査は、それぞれ別途必要です。ポータブルパッケージ形式を参照してください。

OpenAI の掲載用メタデータと、肯定的なシナリオ 5 件および否定的なシナリオ 3 件のレビュアー向けケースは plugin.json に含まれています。これらは提案中のホスト向けテストケースであり、プラグインをインストールして実行した記録ではありません。レビュアー向けの動画はまだ用意されていません。ウェブサイトのデモは、プラグインをインストールして操作する手順の紹介ではありません。

Claude プラグインとオプションの Desktop バンドル

Claude プラグインは integrations/claude にあります。Claude 専用の .claude-plugin/plugin.json および .mcp.json 形式を使用し、レビュー済みの Claude スキルのバイト列を固定して、同じホスト型エンドポイントに接続します。バージョン 0.1.2 では、 対象ユーザー、範囲を限定した調査の作業形態、エビデンスの信頼度レベル、エスカレーションルールを明示的に追加し、 例示用の検索および応答テンプレートはそのまま維持しています。こうした設計上の制御は、 フレームワークへの無条件の対応、インストール先ホストでの動作、ディレクトリへの掲載受理を保証するものではありません。共通の OpenAI スキルとオプションの Desktop バンドルは、引き続き別個の変更されていない成果物です。クリーンな サブフォルダーには、このリポジトリのトップレベルにある bin/ は含まれません。これは、chat と Cowork がプラグイン内で bin/ を受け付けないためです。依存関係をインストールせずに、両方の成果物をビルドします。

python3 scripts/package-claude.py --kind plugin --output /absolute/new/path/magist-claude-plugin-0.1.2.zip
python3 scripts/package-claude.py --kind desktop --output /absolute/new/path/magist-desktop-0.1.1.mcpb

.mcpb には、依存関係のない公開済み 0.1.1 ブリッジとまったく同じものが組み込まれ、Node.js 18 以降が必要です。 署名されておらず、個人用の Desktop テスト向けです。Claude の現在のディレクトリでは、Desktop MCPB の掲載を受け付けなくなりました。公開レビューを受けるには、リモート MCP コネクターと integrations/claude プラグインフォルダーを、 同じ出品元の組織からの相互に関連付けられた 2 件の申請として提出してください。 Claude の現在のディレクトリ申請方法を参照してください。 ここにあるパッケージは、インストール、ポータルでの検証、掲載受理、または Claude ワークフローの完了を意味するものではありません。

ベータ版：コンテンツは弁護士によるレビュー中です。 サーバーは稼働中で、エンジンは安定しています。規制コーパスの内容については、 弁護士による実質的なレビューを進めています。各項目には contentReviewStatus フィールドがあり（reviewed は人間による確認済み、 draft は AI が作成しレビュー待ち）、Magist は調査および弁護士への引き継ぎのための法的な情報を提供しますが、 法的助言は提供しません。出力をローンチの判断に利用する前に、資格を持つ弁護士に相談してください。

ワンライナーでのインストール

Claude Code（CLI） はリモートトランスポートを直接使用します（npm のインストールは不要です）。

claude mcp add --transport http magist https://magist.io/api/mcp

Claude Desktop / Cursor / Windsurf（npx）：ホストの mcpServers 設定にブリッジを追加します。

{
  "mcpServers": {
    "magist": {
      "command": "npx",
      "args": ["-y", "@magist/mcp-server"]
    }
  }
}

• Claude Desktop: Settings -> Developer -> Edit Config (claude_desktop_config.json)。保存後、Claude を再起動してください。

• Cursor: Settings -> MCP -> Add new server を選択するか、~/.cursor/mcp.json を編集します。

• Windsurf: ~/.codeium/windsurf/mcp_config.json を編集してから、再読み込みします。

• Codex: ~/.codex/config.toml に追加します。

  [mcp_servers.magist]
  command = "npx"
  args = ["-y", "@magist/mcp-server"]
  

ChatGPT（Developer Mode / Connectors）、Manus、およびその他のリモート接続対応ホスト： Streamable-HTTP エンドポイント https://magist.io/api/mcp を指すカスタムコネクターを追加します（npm パッケージは不要です）。

動作確認

name: "magist" を含む 200 が返れば、エンドポイントは稼働しています。

curl -s https://magist.io/api/mcp

ツールを一覧表示します（9 個表示されるはずです）。

curl -s -X POST https://magist.io/api/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

ホストに接続したら、Magist に COPPA を調べて Controls を一覧表示するよう依頼してください。 接続が正常に機能していれば、拒否や「そのようなツールはない」というエラーではなく、出典が引用された規制の記録が返されます。

ツール

ツール	返される内容
lookup_regulation(id)	規制1件の構造化レコード：引用情報、管轄、ステータス、レビュー日、平易な言葉による概要、および要件を満たす可能性のある管理策。
search_regulations(query, filters?)	コーパスを対象に、恒久的な引用URL付きで、キーワードとフィルターによる決定論的な検索を行います。
compute_requirements(features, markets, audiences, businessModel?)	決定論的エンジンを実行します：該当する規制と管理策、複雑さの段階、ブロッカー数、対象者ごとの内訳を返します。最大90日間保持される、冪等な公開レシートレポートのリンクを作成または更新します。機密情報ではない公開情報または合成データのみを使用してください。
find_controls(regulationId)	規制の要件を満たす可能性のある管理策。それぞれに優先度を示すシグナルと概要が付いています。
find_vendors(controlId, jurisdiction?)	管理策を実装するベンダーと社内でのアプローチ。工数・コストと情報源の開示が含まれます。Magistはベンダーから支払いを受け取りません。
get_enforcement(regulationId?, since?, limit?)	最近の執行措置。罰則、当局、一次情報源へのリンクが含まれます。
find_counsel(jurisdiction, practiceArea?, language?)	管轄および業務分野別の弁護士ディレクトリを公開します。掲載は推奨を意味しません。
list_feature_catalog()	compute_requirementsが受け付ける、機能・市場・対象者の限定された識別子一覧です。エージェントは分析前に入力を検証できます。
verify_ai_answer(token)	REST APIからの署名付きMagistグラウンディング証明トークンを検証します。Magistが提供した内容を証明するものであり、法的な正確性や適用可能性を証明するものではありません。

8つのツールは、公開コーパスを読み取るか、グラウンディング証明の署名を検証します。 compute_requirementsは、上記の公開レシートレポートも保存します。アクセスに認証は不要ですが、サーバーのレート制限が適用されます。個人情報、機密情報、または秘匿特権の対象となる情報を送信しないでください。ツール呼び出しのテレメトリーが記録される場合があります。ブリッジパッケージのライセンスは、ホスト型プラットフォームには適用されません。

セルフホスティング

MAGIST_MCP_URLを設定して、ブリッジをオープンコーパスおよびエンジンの独自デプロイ先に接続します。

{
  "mcpServers": {
    "magist": {
      "command": "npx",
      "args": ["-y", "@magist/mcp-server"],
      "env": { "MAGIST_MCP_URL": "https://your-host.example.com/api/mcp" }
    }
  }
}

ホスト側LLMの開発者向け

すべてのツール応答は、標準形式のエンベロープでラップされています。Magistの応答をユーザーに表示する場合は、disclaimer.textフィールドをそのまま表示し、出力を指示や結論として言い換えず、practitionerの帰属情報とverificationフィールドを提示してください。counsel_recommendedがtrueの場合は、資格を持つ弁護士への相談を提案し、要約にはcitationsリンクを優先して使用してください。

リンク

• ドキュメント：https://magist.io/mcp
• オープンデータハブ：https://magist.io/data
• ライセンス（本パッケージ）：MIT。コーパスはCC BY-SA 4.0です。