Steward MCP 服务器（StdIO 实现）

关键词

JSON-RPCstdiotool invocationMCP serverLLM integration

使用说明（Markdown 格式）

  • 项目简介

    • Steward MCP 服务器是极简实现的 Model Context Protocol 服务端组件，运行后通过标准输入输出（STDIO）与 MCP 客户端通讯。服务器负责暴露工具集合、提供资源数据访问、以及渲染和提供提示模板的能力，以支持基于模型的上下文服务。

  • 主要功能点

    • 实现 MCP 协议核心请求/响应处理：initialize、initialized、tools/list、tools/call、ping 等。
    • MCP 服务器端具备服务器端工具发现能力（通过 stewards 的工具注册与发现模块），能将工具清单提供给 MCP 客户端。
    • 支持简单的工具调用路径：客户端请求调用某个工具，服务器返回执行结果，包含文本内容、Tool 调用记录等。
    • 基于 STDIO 的传输方式，直接通过进程的标准输入输出进行通信，方便与 LLM 客户端嵌入式集成。
    • 结构化的错误处理：对未知方法/未知工具会返回标准的错误响应。

  • 安装与运行

    • 安装方式：通过项目源码或打包后直接使用，无需额外依赖即可运行 MCP 服务端。
    • 运行命令（在仓库根目录或已安装环境中执行）：
      • python -m steward.mcp
    • 运行后服务器会等待来自 MCP 客户端的 JSON-RPC 请求，按照 MCP 规定的格式返回结果。

  • 服务器配置（MCP 客户端使用配置信息建立连接） 说明：MCP 客户端需要通过 JSON 配置来定位并启动 MCP 服务器。配置仅用于客户端端的发现与连接，服务器端实现无需改动即可使用。 以下为示例配置（以 JSON 表示，注释以中文说明）： { "mcpServers": { "steward-mcp": { "command": "python", "args": ["-m", "steward.mcp"] } // 说明：上面的配置会让 MCP 客户端启动 Steward 的 MCP 服务器进程，并通过标准输入/输出进行通信 } }

  • 基本使用方法

    • 启动服务器后，MCP 客户端发送初始化请求，服务器返回服务器信息。
    • 通过 tools/list 获取可用工具列表及描述。
    • 通过 tools/call 调用具体工具，并获得输出内容或文本块。
    • 客户端可按需求继续发送后续请求，服务器返回相应的 JSON-RPC 响应或通知。

  • 重要注意

    • 服务器实现为标准 STDIO MCP 服务端，适合作为嵌入式后端服务，便于与 LLM 客户端集成并提供一致的上下文与工具能力。

服务器信息

访问项目