使用说明（Markdown 格式）

• 项目简介

  • 该仓库包含一个针对 MCP（Model Context Protocol）的 OSS 实现，提供对 MCP 请求的处理逻辑、MCP 请求/响应的数据结构，以及與 HealingIntent 的企业对接入口。OSS 版本仅提供分析与建议，不执行实际操作，确保在安全边界内帮助 LLM 客户端进行决策。

• 主要功能点

  • MCP 请求/响应处理：接收 MCP 请求，返回标准化的 MCPResponse，或在必要时提供 HealingIntent 以供 Enterprise 执行对接。
  • Advisory 模式与边界保护：严格遵循 OSS 限制，禁止执行、自动化批准或自主执行，提供审计和升级路径信息。
  • 安全与合规：内置安全护栏、 blast radius、日志审计、以及与企业版的对接边界（HealingIntent 框架）。
  • 记忆与推理支持（OSS 侧）：提供对近期/历史事件的推理线索、RAG 相关的相似事件检索（如有配置）。
  • 与客户端的对接示例：提供标准化的请求/响应格式，便于 MCP 客户端与服务端对接。

• 安装步骤

  • 使用 OSS 版的 MCP 服务前，请确保依赖安装就绪（框架核心、必要的依赖库）。安装后即可通过指定的入口启动服务组件（具体入口可按团队环境自建的 RPC/HTTP 层对接）。
  • 典型环境中的依赖与版本请参考项目的要求文件和官方文档。

• 服务器配置（供 MCP 客户端使用的启动信息说明） 说明：MCP 客户端需要一个 JSON 形式的服务器配置信息来连接 MCP 服务器。以下仅给出配置示例描述，实际启动需在你的运行环境中实现对应的网络/RPC 服务端口与绑定。配置示例以 JSON 描述，包含服务器名称、启动命令与参数注释，帮助你理解需要传递的连接信息。MCP 客户端本身不需要执行代码，仅读取此配置以建立连接并发送 MCP 请求。

  { "server_name": "arf-mcp-oss", "command": ["python", "-m", "agentic_reliability_framework.engine.mcp_server"], "args": [ "--host", "0.0.0.0", "--port", "8000" ], "notes": "OSS 版本为 Advisory Only，禁止执行、审批或自主执行行为。客户端通过此服务器的 JSON-RPC 风格请求与响应进行交互。对于生产环境，请据需搭建实际的 JSON-RPC/HTTP 框架来暴露 MCP 接口。" }

• 基本使用方法

  • 启动：在具备运行环境的服务器上启动上述配置对应的服务组件（结合你们现有的 RPC/HTTP 服务框架）。OSS 版本仅提供分析与建议的接口，不进行执行。
  • 调用方式：客户端向服务器发送 MCP 请求（格式包含 tool、component、parameters、metadata 等字段），服务器返回 MCPResponse（包含 status、executed、message、result 等字段），若需要 Enterprise 执行，将返回 HealingIntent 对象用于对接。
  • 结果解读：客户端解析返回的 MCPResponse 的状态与信息，若需要升级/对接 Enterprise，服务器应提供相应的升级路径信息与 enterprise 专用字段。

• 注意事项

  • OSS 模式下执行能力被禁用，所有分析都应在边界条件下进行，确保安全性与可审计性。
  • 若后续升级为 Enterprise，需按照官方升级流程开启执行、审批等能力。