使用说明（Markdown格式）

• 项目简介

  • 这是 Rogue 框架中的一个实际可运行的 MCP 服务器示例。它通过 FastMCP 框架将一个 Shirtify 代理包装成一个 MCP 服务，向 MCP 客户端暴露名为 send_message 的工具，用于与代理进行对话并获取回应。

• 主要功能点

  • 实现 MCP 服务器的核心结构：注册一个名为 send_message 的工具，接收来自 Rogue 的消息并调用底层代理返回文本回应。
  • 支持多传输协议：可通过 SSE、streamable_http 等传输方式与客户端进行通信。
  • 提供完整的示例代码与运行入口，便于在 Rogue 生态中快速接入自有代理。
  • 结合 LangGraph 的 Shirtify 代理实现，演示将现有代理通过 MCP 封装成可与 LLM 客户端对话的服务。

• 安装与运行步骤

  • 进入示例目录并启动 MCP 服务：
    • 路径：examples/mcp/tshirt_store_langgraph_mcp
    • 运行方式：以 Python 解释器直接执行示例，指定主机、端口与传输方式，例如使用 streamable_http 传输。
  • MCP 服务启动后，MCP 客户端即可使用 send_message 工具对接此服务进行对话。服务端实现会在请求中接收消息并返回代理的回应。

• 服务器配置（供 MCP 客户端参考的JSON配置示例）

  • server_name: shirtify_mcp_server
  • command: python
  • args: ["-m", "examples.mcp.tshirt_store_langgraph_mcp", "--host", "127.0.0.1", "--port", "10001", "--transport", "streamable_http"] 注释：该配置用于 MCP 客户端连接到服务器时所需的启动信息，包含服务器名称、启动命令和参数。MCP 客户端本身不需要额外的代码，只需按该结构在自己的环境中配置即可。

• 基本使用方法

  • 启动 MCP 服务器（如上配置所示）。确保服务器在指定地址与端口对外暴露。
  • 使用 MCP 客户端连接到服务器，调用 send_message 工具，传入需要与 Shirtify 代理对话的文本消息。
  • 服务器将返回代理的回复文本，客户端可据此继续后续对话。

• 重要提示

  • 该示例聚焦展示通过 MCP 封装现有代理的方式，实际在生产环境中应完善鉴权、错误处理与日志策略。