Magist

@magist/mcp-server

通过模型上下文协议将 Magist 连接到你的 AI 宿主。Magist 是一个开放、确定性且带引用的产品监管参考资料：哪些法律适用于某种产品、这些法律规定了哪些义务和控制措施，以及每项内容背后的原始来源。开放数据（CC BY-SA 4.0）、确定性引擎（相同输入产生相同输出，不调用大模型）、永久引用 URL，以及每个响应均注明的从业者姓名。

此软件包是连接到托管服务 https://magist.io/api/mcp 的轻量级 stdio 桥接器。支持远程连接的宿主可以跳过此桥接器，直接连接该 URL。

离线回执完整性

单独的 receipt-v9 内容完整性工具仅使用 Node 内置模块检查已保存 JSON 正文的哈希值。它不会发起网络请求，也不会运行引擎或验证发送方身份。其合成测试和源代码独立于已发布的桥接器和插件载荷。

Research 插件包（实验性预览）

此仓库还包含单独的 magist-research 0.1.1 便携式插件：根目录中的 plugin.json、mcp.json 中的远程连接，以及新编写的 skills/magist-research/ 工作流。它直接连接公共 HTTPS 服务，不会运行 npm stdio 桥接器。

便携式连接仅使用 type 和 url，符合 Agent Plugins 1.0.0 MCP 架构的要求。此端点无需身份验证。该架构不接受某些特定宿主示例中所示的服务端身份验证扩展，因此此处省略了这些扩展。仅通过架构验证并不能证明宿主能够安装并运行完整插件。

请使用 Python 3.9 或更高版本创建此精简源代码包：

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

ZIP 包含两个便携式清单、该技能及其 MCP 依赖声明、现有的公开 Magist 图标，以及此仓库的 MIT 许可证。它不包含桥接器可执行文件、依赖项、私有平台源代码和素材。插件版本独立于 @magist/[email protected]。

这是一个拟议的集成包，并非已获接受的目录列表或宿主验证证书。公开提交使用 OpenAI 的 With MCP 提交流程；发布者验证、实际宿主和审核者用例、媒体、任何必需的视觉素材、连接检查和提交审核仍是独立要求。请参阅便携式软件包格式。

plugin.json 中包含 OpenAI 列表元数据和五个正向、三个负向的审核者场景。这些是拟议的宿主用例，并非已完成的插件安装运行记录。目前尚未提供审核者视频；网站演示也不是已安装插件的操作演示。

Claude 插件和可选的 Desktop 捆绑包

Claude 插件位于 integrations/claude。它采用 Claude 独有的 .claude-plugin/plugin.json 和 .mcp.json 格式，固定使用经过审核的 Claude 技能字节，并连接到同一个托管端点。0.1.2 版本新增了明确的受众、限定范围的研究工作形式、证据置信度等级和升级规则，同时保留了示例查询和响应模板。这些设计控制并不能保证框架无条件就绪、已安装主机上的行为或目录收录。共享的 OpenAI 技能和可选的 Desktop 捆绑包仍是独立且未更改的构件。其干净的子文件夹不包含此仓库顶层的 bin/，因为聊天和 Cowork 不接受插件中的该目录。无需安装依赖项即可构建这两个构件：

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 插件文件夹作为两个关联提交。请参阅 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 软件包）。

验证是否可用

返回 200 且包含 name: "magist" 表示端点已上线：

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)	一项法规的结构化记录：引文、管辖区、状态、审查日期、通俗易懂的摘要，以及可能满足该法规要求的控制措施。
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 接受的封闭式功能、市场和受众标识符，供 Agent 在分析前验证输入。
verify_ai_answer(token)	验证来自 REST API 的已签名 Magist 溯源证明令牌。它能证明 Magist 提供了什么内容，但不能证明其法律正确性或适用性。

其中八个工具用于读取公开语料库或验证溯源证明签名。 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" }
    }
  }
}

致宿主大模型开发者

每个工具响应都采用规范封装。向用户呈现 Magist 响应时：逐字呈现 disclaimer.text 字段；不要将输出转述为指令或结论；显示 practitioner 署名和 verification 字段；当 counsel_recommended 为 true 时，建议用户咨询持牌律师；总结时优先使用 citations 链接。

链接

• 文档：https://magist.io/mcp
• 开放数据中心：https://magist.io/data
• 许可证（本软件包）：MIT。语料库采用 CC BY-SA 4.0 许可。