使用说明

• 项目简介

  • 该项目实现了一个 OCTAVE 的 MCP 服务器，核心职责是为 LLM 客户端提供规范化的上下文信息与功能入口。通过 MCP 协议实现对工具的注册、执行以及对上下文模板（Prompts）的统一访问，便于在多轮对话中管理上下文、执行外部操作并渲染提示模板。

• 主要功能点

  • 注册与暴露工具：实现 octave_ingest、octave_eject、octave_create、octave_amend 等 MCP 工具，并通过服务器对外提供工具列表与调用入口。
  • 资源与上下文管理：提供对 OCTAVE 文档的解析、标准化、投影等能力，便于 LLM 在对话中获取稳定的上下文。
  • JSON-RPC 交互模型：服务器通过 MCP 的请求/应答模式与客户端通信，支持工具查询与调用、结果回传等场景。
  • 会话与能力声明：服务器实现了对能力的声明与会话管理的基础能力，便于跟踪工具使用、输出结果以及潜在的修正记录。
  • 可扩展传输支持：当前实现基于 stdio 的 MCP 传输，设计上可进一步扩展为 SSE、WebSocket 等传输通道。

• 安装步骤

  • 克隆仓库并进入项目根目录。
  • 安装依赖并在开发环境中就地开发运行。
  • 直接以模块方式启动 MCP 服务器（示例路径如下，实际执行时请按环境配置执行）。
  • 运行服务器前请确保 Python 3.11 及以上版本可用。

• 服务器配置（客户端需要的最小配置示例，JSON 格式）

  • 服务器名称：octave-mcp
  • 启动命令与参数（示例，实际请按运行环境调整）：
  • { "server": "octave-mcp", "command": "python", "args": ["-m", "octave_mcp.mcp.server"] } 说明：该配置用于 MCP 客户端连接到服务器进行工具查询与调用。该配置包含服务器名称、启动命令以及启动参数等，客户端在建立连接时需要使用到该信息。实际运行时请确保工作路径、虚拟环境与依赖已就绪。

• 基本使用方法

  • 启动服务器：使用上述启动命令在具备 MCP 客户端能力的环境中启动服务器。
  • 客户端交互流程概览：客户端通过 JSON-RPC 方式向服务器请求工具列表、调用具体工具（如 ingest/eject/create/amend），服务器返回结构化结果或通知。
  • 日常使用场景包括：将 lenient OCTAVE 文档经 ingest 工具规范化、将结果通过 eject 进行投影渲染、以及通过 create/amend 对文件进行写入与修改等。

• 其他注意

  • 该实现核心聚焦在 MCP 服务端能力与工具注册/调用的完整性，具体的生产化、鉴权、持久化存储、并发控制等场景可在后续迭代中扩展。