MCP Server MAS Sequential Thinking

使用说明（Markdown格式）

• 项目简介 这是一个基于 MCP（Model Context Protocol）构建的后端服务器，使用 MAS（多智能体系统）进行协调以实现“Sequential Thinking”（序列化思考/推理）的能力。服务器管理资源、可注册并执行工具、并可定义与渲染提示模板，客户端通过 JSON-RPC 与服务器进行交互。

• 主要功能点

  • MCP核心功能：处理符合 MCP 协议的请求和响应，包括资源读取/写入、工具调用、提示模板的获取与渲染等。
  • 资源与工具管理：内置资源、工具和思维模板，支持扩展与自定义。
  • Prompts（提示模板）：定义与渲染用于与 LLM 的交互的提示模板。
  • 会话与模型协同：通过一个 MAS 团队（Planner、Researcher、Analyzer、Critic、Synthesizer）在 coordinate 模式下协同完成任务并进行汇总。
  • 会话生命周期与分支能力：支持分支思路、 revision（修订）以及分支点的跟踪与记录。
  • 传输协议支持：默认通过标准输入输出（stdio）进行 JSON-RPC 通信，未来可扩展到 SSE/WebSocket 等传输。

• 安装步骤

  1. 安装 Python 3.x 环境（建议 3.8 及以上）。
  2. 安装依赖（示例，实际依赖包名请按项目实际需要安装）：pip install mcp agno pydantic python-dotenv
  3. 启动服务器：直接运行 main.py。服务器会以 MCP 服务器模式启用，默认通过 stdio 进行通信。
  4. 如需环境变量，按需要配置，如 DEEPSEEK_API_KEY、EXA_API_KEY 等（依赖具体实现，可选）。
  5. 客户端接入前，请确保已了解 MCP 客户端配置项（见下方“服务器配置”）。

• 服务器配置（MCP 客户端须提供的启动信息，JSON 格式；包含 server name、command、args 等） { "server_name": "SequentialThinking MCP Server", "command": "python3", "args": ["main.py"] } 说明：

  • server_name: 服务器在客户端侧的标识名称，用于区分不同的 MCP 服务。
  • command: 启动服务器的执行命令（不含参数的可执行程序路径，例如 python3）。
  • args: 启动命令的参数列表，此处应包含要执行的入口脚本，如 main.py。此配置用于客户端在本地创建并管理与服务器的进程通信。

• 基本使用方法

  1. 客户端通过暴露的 MCP 接口（JSON-RPC）向服务器发送请求，例如读取资源、调用工具、获取或渲染 Prompts。
  2. 服务器通过 MCP 协议对请求进行处理，返回标准的 JSON-RPC 响应或通知。
  3. 若需协同推理，服务器内置的 MAS 团队将协同产生最终输出并提供合成结果及后续步骤建议（如修订或分支建议）。
  4. 如需查看日志或调试信息，请查看服务器输出与日志文件（实现中为 esper 的日志系统）。

• 重要注意

  • 本实现的实际运行示例为通过 Python 脚本启动，若您使用的客户端工具依赖特定 MCP 版本，请确保两者版本兼容。
  • 若要使用 Exa、DeepSeek 等工具，请按环境变量和 API Key 的要求提供相应密钥。