Scilab Xcos MCP服务器

远程优先的MCP服务器,用于在Hugging Face Spaces上进行Scilab Xcos工程处理。

  • by Antniom
  • Scilab
  • 本地部署
  • 更新于
在 GitHub 查看 Antniom/scilab-xcos-mcp-server

使用说明


标题:Scilab Xcos MCP服务器 表情符号⚙️" 颜色来源:灰色 颜色:红色 sdk:docker 应用端口:7860

Scilab Xcos MCP服务器

用于拥抱面部空间Scilab Xcos工程的远程第一台MCP服务器。

端点

  • 工作流UI: /workflow-ui
  • MCP端点: /mcp
  • 健康检查: /healthz

运行时

空间以托管模式运行:

  • XCOS_SERVER_MODE=http
  • XCOS_VALIDATION_MODE=subprocess

通过将Scilab作为容器内的子流程启动,可以无头执行验证。

托管超时默认值:

  • 子流程验证: 180s
  • 轮询回退验证: 420s
  • 异步验证作业: 720s

可选覆盖:

XCOS_SCILAB_SUBPROCESS_TIMEOUT_SECONDS=180
XCOS_POLL_VALIDATION_TIMEOUT_SECONDS=420
XCOS_VALIDATION_JOB_TIMEOUT_SECONDS=720
XCOS_VALIDATION_WORKER_URL=
XCOS_VALIDATION_WORKER_TOKEN=

部署

此存储库旨在部署为Docker空间。

看 DEPLOY_TO_HUGINGGFACE_SPACES.md.

Docker构建下载官方Scilab 2026.0.1 在映像构建期间进行Linux存档,因此存储库不需要提供Scilab发行版。

跨平台MCP应用元数据

服务器现在发布MCP应用程序元数据,旨在从同一位置在Claude和ChatGPT中工作 /mcp 端点:

  • 小工具返回紧凑 structuredContent 加上完整的小部件有效载荷 _meta.widget
  • 小部件工具同时宣传这两者 _meta.ui.resourceUri 和 openai/outputTemplate
  • 工作流UI资源发布 _meta.ui.csp 和 _meta.ui.domain

市场部署的可选环境变量:

XCOS_PUBLIC_BASE_URL=https://your-host.example
XCOS_PUBLIC_MCP_URL=https://your-host.example/mcp
XCOS_UI_RESOURCE_DOMAINS=https://esm.sh
XCOS_UI_CONNECT_DOMAINS=
XCOS_UI_FRAME_DOMAINS=
XCOS_UI_BASE_URI_DOMAINS=

笔记:

  • XCOS_PUBLIC_MCP_URL 在计算Claude应用程序域哈希时优先
  • 如果未设置,服务器将从以下位置导出公共MCP URL XCOS_PUBLIC_BASE_URL 加 /mcp
  • XCOS_UI_RESOURCE_DOMAINS 默认为 https://esm.sh 因为UI桥客户端当前是从该源加载的

开发人员调试输出

普通用户只能收到紧凑的验证结果。

要为开发人员会话公开内部验证诊断,请设置此Space变量:

XCOS_DEBUG_TOOL_OUTPUT=1

然后重新启动Space。

当启用时, verify_xcos_xml 和 xcos_verify_draft 包括a debug 物体在其有效载荷中。

验证配置文件

草稿验证现在支持两个显式配置文件:

  • full_runtime
    • 默认为 xcos_start_validation 和 xcos_verify_draft
    • 运行结构验证和完整的Scilab模拟
    • 可以在符合条件的运行时失败时使用长期轮询工作器回退
  • hosted_smoke
    • 用于拥抱面部 cpu-basic 部署检查
    • 运行结构验证和Scilab加载/导入检查
    • 不打电话 scicos_simulate(...)
    • 不使用轮询工作器回退

成功的验证有效载荷包括 validation_profile 因此,调用者可以判断结果是来自部署安全导入验证还是完全模拟。

可选验证工作空间

您可以保持MCP空间打开 cpu-basic 仅卸载 full_runtime 验证到单独的拥抱面部空间。

当MCP空间设置时:

XCOS_VALIDATION_WORKER_URL=https://<worker-space>.hf.space
XCOS_VALIDATION_WORKER_TOKEN=<shared-secret>

然后 full_runtime 验证通过HTTP委托给worker,而 hosted_smoke 继续在MCP空间内本地运行。

工人空间使用 validation_worker.py 和 Dockerfile.validation-worker.

远程烟雾测试

tools/remote_hf_smoke_test.py 现在默认为:

  • --validation-profile hosted_smoke
  • 只有严格的成功;没有降级超时成功模式
  • 客户端等待预算 900s

使用 --validation-profile full_runtime 仅当您明确希望实时空间尝试完全模拟时,才用于手动诊断。

备注

  • 存储库不再包含旧的本地Windows启动器工作流。
  • get_xcos_block_data 现在默认情况下是轻量级的。仅在需要时请求帮助和额外示例。
  • 验证小部件重用缓存的验证结果,以避免重复的验证调用。