DiffBeam Gaussian Beam Optics

Gaussian Beam 的 DiffBeam

DiffBeam 是一项确定性的高斯光束光学服务，面向 AI Agent 和工程工具。其匿名 MCP 可搜索光学元件目录，并报告服务端和目录修订版本。另有独立的、需要凭据的 Direct Agent Bridge，可分析并应用针对用户 Gaussian Beam planner 工作区的修订版编辑。

DiffBeam 不托管或代理语言模型。可使用任何兼容的 AI 客户端。

远程 MCP 服务

• 端点：https://catalog-api.gaussian-beam.com/mcp/
• 发布版本：2.0.0
• 注册表名称：com.gaussian-beam/diffbeam
• 人类可读文档：https://gaussian-beam.com/mcp/
• 机器可读清单：https://gaussian-beam.com/.well-known/mcp/server.json
• 合约：https://gaussian-beam.com/mcp/contracts/

MCP 客户端通过 Streamable HTTP 直接连接。公共端点无需身份验证、无状态且只读，不具备求解器、设计链接或工作区权限。

无需安装的 Direct Agent Bridge

能够联网并发送 HTTPS POST 请求的 AI 无需原生 MCP 安装。planner 的 连接你的 AI 对话框会创建一个特定于工作区的端点、临时的限定范围凭据，以及可直接复制的提示词。常规流程如下：

1. get_workspace
2. 执行一项小型的 planner 原生操作，例如 add_lens 或 set_wavelength
3. 检查返回的光束反馈，并说明当前可见的修订版本
4. 使用下一个有用的操作进行优化；仅在明确只需预览时使用 dry_run

请阅读 Direct Agent Bridge 指南。切勿将工作区凭据放入 URL、公共页面、模型配置、日志或代码库中。

公共 MCP 工具

• get_diffbeam_state
• search_fibers
• search_fiber_collimators
• search_lenses

需要凭据的 Bridge 操作

Bridge 不属于匿名 MCP。它使用来自 连接你的 AI 的临时能力，并将操作分为：

• 工作区读取、更改和修订历史记录；
• 确定性求解、光束摘要、束腰查找和点测量；
• 光纤、准直器和透镜目录搜索；
• planner 原生的光源、元件、参数、单位和光束目标变更；
• 撤销和恢复修订版本。

写入需要提供当前的 expected_revision，并默认创建实时 planner 修订版本。公共 MCP 无法访问这些操作。

光学设计实例指南

• 4F 高斯光束扩束器
• 根据模场直径进行光纤准直
• 高斯束腰定位
• 实用焦距选择
• MCP 示例

examples/ 中的 JSON 文件是供文档和 Bridge 工作流使用的 planner 导入示例，不能作为匿名目录 MCP 接受的参数。

代码库范围

此公共代码库包含发现元数据和集成文档，不包含生产凭据、私人工作区数据、遥测数据或部署配置。文档和示例采用 Apache-2.0 许可。

请按照 SECURITY.md 中的说明私下报告安全问题。