mcpField
F
fusion-mcp

fusion-mcp

github.com/equinorAgent 工作流2.0k 次安装
代码仓库

关于 fusion-mcp

面向配置 Fusion MCP 的用户，提供设置与故障排查指导。内容侧重托管生产服务、Entra 身份验证，以及确认工具正常响应的检查步骤。

主要功能

  1. 01说明 Fusion MCP 能力
  2. 02指导在 VS Code 配置托管服务
  3. 03说明 Entra 登录与访问控制
  4. 04验证初始化、工具列表和调用
  5. 05排查常见设置故障

适用场景

  1. 01在 VS Code 配置 Fusion MCP
  2. 02检查 MCP 工具是否响应
  3. 03诊断身份验证或工具错误

MCP 相关

指导用户在 MCP 客户端（主要是 VS Code）配置托管的 Fusion MCP 服务，并通过初始化、列出工具和调用工具进行验证。还涵盖身份验证与设置故障排查。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/equinor/fusion-skills --skill fusion-mcp

安装后在 Claude Code 中输入/fusion-mcp确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

CHANGELOG.md
assets/
bug-report-template.md
references/
mcp-call-snippets.md
README.md
vscode-mcp-config.md

详细介绍

Fusion MCP 设置指南

适用场景

在用户询问以下内容时使用：

  • Fusion MCP 是什么
  • 它能做什么
  • 如何安装／配置
  • 如何验证其是否正常运行
  • 如何排查 Fusion MCP 设置失败的问题

常见触发语句：

  • “fusion mcp 是什么”
  • “帮我设置 fusion mcp”
  • “如何在 copilot 中使用 fusion mcp”

不适用场景

  • 实现与 MCP 设置无关的产品功能
  • 未经用户确认便对环境进行破坏性更改
  • 臆测不可见的私有代码库细节
  • 回答关于 Fusion Framework API、EDS 组件或技能目录的、需要来源支持的问题——MCP 启动后，请使用 fusion-research

必需信息

在提出设置步骤前，先收集：

  • 用户的环境（操作系统、编辑器／运行时）
  • 目标 MCP 客户端（主要目标为 VS Code）
  • 用户是否可以使用 Equinor Entra 账户

如果缺少信息，请先简短地提出后续问题。

说明

  1. 说明此 MCP 服务提供的功能：
    • 面向 Fusion 的 MCP 检索和工作流支持能力
    • 以托管服务形式提供——大多数开发者无需本地基础设施
    • 检索工具：search、search_framework、search_docs、search_eds、search_indexes、search_backend_code
    • 工具范围可能随时间变化
  2. 指导用户设置托管生产服务——这是唯一推荐的方式：
    • 无需 Docker、API 密钥或本地克隆
    • VS Code 使用 Microsoft Entra（Equinor 账户）进行身份验证
    • 使用生产环境的一键安装链接（参见 references/vscode-mcp-config.md）
    • 或使用 "type": "http" 和服务 URL 进行手动配置（参见 references/vscode-mcp-config.md）
    • 除非用户有明确的运维需求，否则不要建议本地 Docker、GHCR 或可自托管的替代方案
  3. 说明身份验证流程：
    • 首次调用工具时，VS Code 会提示用户使用 Equinor Entra 账户登录
    • 令牌由系统自动管理；可以时会静默续期，必要时会弹出交互式提示
    • 访问权限由现有 Fusion 角色分配控制
  4. 提供轻量级的 MCP 冒烟测试：
    • 运行 initialize 并确认响应成功
    • 运行 tools/list 并确认至少返回一个工具
    • 对可用工具运行一次无破坏性的 tools/call
    • 通过标准：调用响应非空（content 或 structuredContent 中包含数据）
    • 注意：不要硬编码固定的工具列表；不同版本的工具清单可能会变化
  5. 按照文档规定的顺序排查问题：
    • 未出现 Entra 登录提示 → 检查配置中的 oauth.clientId，并确认 VS Code 已使用 Equinor 账户登录
    • 401 Unauthorized → 通过 VS Code 账户设置重新进行身份验证；确认 Equinor Entra 账户处于启用状态
    • tools/list 返回空结果或工具调用失败 → 确认 VS Code 中已选择／启用 MCP 服务条目，然后重新加载后重试
    • 工具行为不完整 → 检查 VS Code 的 Output > Copilot 中的错误详情，并重启 MCP 服务
  6. 如果 MCP 设置失败，或用户要求提交错误报告，请根据 assets/bug-report-template.md 起草错误报告。
    • 默认目标代码库：equinor/fusion-mcp
    • 包含具体的复现步骤、预期行为与实际行为，以及已尝试的排查方法
    • 包含非敏感的环境详情（操作系统、VS Code 版本、MCP 服务 URL、Entra 账户类型）
    • 绝不包含机密、令牌或原始凭据值
  7. 对于不确定之处或代码库私有限制，请明确说明假设，并链接权威文档，不要猜测。

预期输出

返回：

  • 简要说明 Fusion MCP，以及适用场景
  • 根据用户环境量身定制的托管生产环境设置步骤
  • 验证清单：运行 initialize（预期成功响应）、运行 tools/list（预期至少有一个工具）、运行一次 tools/call（预期 content 或 structuredContent 非空）
  • 根据观察到的错误症状提供对应的故障排除步骤
  • Bug 报告草稿（当设置失败、行为异常或用户提出请求时），使用 assets/bug-report-template.md，默认目标为 equinor/fusion-mcp
  • 用户需要可复制粘贴的自动化辅助内容时，提供脚本片段
  • 明确列出假设和缺失的信息
  • 指向所用的上游文档具体页面

参考资料

安全与限制

绝不：

  • 索取或泄露机密信息、令牌或凭据
  • 编造项目文档未支持的设置命令
  • 未经验证输出就声称设置成功
  • 未经用户明确确认就运行破坏性命令

始终：

  • 优先以官方代码库文档为准
  • 引导用户使用托管生产环境服务；不要建议使用本地 Docker 或可自托管的替代方案
  • 首先提供遵循最小权限原则、尽量少做更改的设置指导
  • 将已确认的事实与假设分开

评论

支持 Markdown