Octave MCP Server

使用说明（Markdown 摘要）

• 项目简介

  • 这是一个基于 MCP 的服务器实现，旨在把“资源、工具、提示模板”等能力统一暴露给搭建在 LLM 之上的应用。服务器通过 JSON-RPC 与客户端通信，支持多种传输协议并具备基本的会话管理和能力声明能力。

• 主要功能点

  • 资源与数据访问：托管并管理允许 LLM 客户端读取和写入的 Resources。
  • 工具注册与执行：注册并执行外部功能，例如数据校验、转换、模板化输出等。
  • Prompts 与模板渲染：定义并渲染提示模板，支持可定制的 LLM 交互模式。
  • JSON-RPC 通信：统一的请求/响应格式，便于 LLM 客户端远程调用。
  • 会话与能力声明：管理会话、能力说明以及对外暴露的能力边界。
  • 传输协议扩展：默认以标准输入输出（stdio）为传输，另支持 HTTP、SSE、WebSocket 等传输方式，适配不同部署场景。
  • 安全与扩展性：提供工具禁用配置、日志与审计、扩展点以接入自定义工具与资源。

• 安装步骤

  • 安装软件包：使用 Python 包管理工具从仓库获取并安装。
  • 启动服务：可通过 CLI 启动，示例包括使用 http 传输的命令，以及默认的 stdio 传输方式。

• 服务器配置（MCP 客户端所需信息）

  • server_name: octave-mcp
  • command: octave-mcp-server
  • args: ["--transport", "http", "--port", "8080"] 注释：上述配置用于 MCP 客户端通过 HTTP 传输与服务器建立连接。若不使用 HTTP，而使用 STDIO，可仅指定命令，端口等参数可按实际部署调整。

• 基本使用方法

  • 启动服务器（HTTP 传输示例）：octave-mcp-server --transport http --port 8080
  • 客户端配置：将服务器的 name、启动命令及参数写入客户端的 MCP 配置，以便建立连接并发送资源读取、工具调用、Prompts 获取等请求。
  • 常用操作：通过 JSON-RPC 调用读取资源、调用工具、获取 Prompts；服务器端处理请求并返回 JSON-RPC 响应。
  • 调试与扩展：可通过禁用工具（环境变量 DISABLED_TOOLS）来限制客户端可访问的工具集合，便于分阶段发布与权限控制。