Model Context Protocol (MCP) Servers: Sequential Thinking with bonus Leave Management server.

Model Context Protocol (MCP) 服务：顺序思考，另附休假管理服务。

本项目使用 FastMCP 框架实现了两个 Model Context Protocol (MCP) 服务：

• 顺序思考：用于结构化问题解决的工具，适用于供应链管理规划等任务。
• 休假管理器：供 HR 管理员工休假任务的 AI 工具，可与模拟休假数据库交互。

这些服务通过 main.py 脚本并发启动，并可通过 Claude Desktop 进行查询。Claude Desktop 可集成 MCP 服务，并使用 Model Context Protocol 发送 API 请求。

项目结构

directory/
├── main.py              # Launches both MCP servers
├── leave_manager.py     # Leave Manager MCP server
├── sequential.py        # Sequential Thinking MCP server

功能

顺序思考 MCP 服务

• 用途：使用 Model Context Protocol 进行结构化、逐步的问题解决，适用于供应链管理等复杂任务的规划。
• 工具：sequential_thinking
  • 将问题拆解为一系列思考步骤。
  • 支持修改思考内容、为备选策略创建分支，以及动态调整步骤数量。
  • 通过 sessionId 保持上下文。
• 使用场景：规划供应链、项目或任何需要迭代推理的任务。
• 端口：运行于 http://localhost:8001。

休假管理器 MCP 服务

• 用途：使用 Model Context Protocol 协助 HR 管理员工休假。
• 工具：
  • get_leave_balance：查看员工剩余的休假天数。
  • apply_leave：申请指定日期的休假。
  • get_leave_history：查看员工的休假记录。
• 资源：greeting://{name}，用于发送个性化问候。
• 端口：运行于 http://localhost:8000。

主启动器

• main.py：使用 multiprocessing 在各自的端口上并发运行两个服务。

前置要求

• Python：版本 3.8 或更高。
• Claude Desktop：用于向服务发送 MCP 查询。
• uv：用于安装依赖项的包管理器。
• 操作系统：已在 Linux（例如 Ubuntu）上测试。

设置步骤

按照以下步骤设置项目：

1. 安装 Claude Desktop：

   • 从官方来源下载并安装 Claude Desktop。
   • 确保已配置好 API 查询发送方式（例如，通过查询输入框）。

2. 安装 uv：

   pip install uv
   

3. 创建项目目录：

   uv init my-first-mcp-server
   cd my-first-mcp-server
   

4. 添加 MCP CLI：

   uv add "mcp[cli]"
   

5. 添加服务代码：

   • 将以下文件放入 my-first-mcp-server/：
     • main.py：两个服务的启动器。
     • leave_manager.py：休假管理器服务代码。
     • sequential.py：顺序思考服务代码。
   • 确保代码与提供的实现一致（请参阅项目仓库或文档）。

6. 运行服务：

   • 不要使用 uv run mcp install main.py（该命令可能因存在多个服务而失败），而应运行：

     uv run python main.py
     

7. 重启 Claude Desktop（如有需要）：

   • 通过任务管理器（Windows）或 killall（Linux）终止所有正在运行的 Claude Desktop 实例。
   • 重启 Claude Desktop，确保其识别正在运行的服务。

用法

运行服务

使用以下命令启动两个服务：

cd ~/my-first-mcp-server
uv run python main.py

这将启动：

• 运行于 http://localhost:8000 的休假管理器。
• 运行于 http://localhost:8001 的顺序思考服务。

注意：保持终端打开，以维持服务运行。

通过 Claude Desktop 交互

使用 Claude Desktop 的查询输入框，通过 Model Context Protocol 向服务发送 JSON 查询。以下是两个服务的示例，重点展示如何使用顺序思考服务进行供应链管理。

Sequential Thinking MCP 服务

• 端点：http://localhost:8001/tool/sequential_thinking
• 用途：使用 MCP 将供应链拆分为多个步骤、修订计划或探索替代方案。
• 输入：将 JSON 查询粘贴到 Claude Desktop 的查询框中并提交。

示例：规划智能手表的供应链

1. 确定目标：

   {
     "thought": "Define objective: Plan a cost-efficient supply chain for a new smartwatch, ensuring global delivery within 5 months.",
     "nextThoughtNeeded": true,
     "thoughtNumber": 1,
     "totalThoughts": 8
   }
   

   • 在 Claude Desktop 中提交（例如，粘贴到查询框中并点击“发送”）。
   • 从响应中复制 sessionId（例如，123e4567-...）。

2. 选择供应商：

   {
     "sessionId": "<sessionId>",
     "thought": "Select suppliers: Source microchips from Supplier X (Taiwan), displays from Supplier Y (South Korea), batteries from Supplier Z (China).",
     "nextThoughtNeeded": true,
     "thoughtNumber": 2,
     "totalThoughts": 8
   }
   

   • 将 <sessionId> 替换为步骤 1 中的 ID。

3. 规划制造：

   {
     "sessionId": "<sessionId>",
     "thought": "Plan manufacturing: Assemble smartwatches in Factory A (Vietnam) for low labor costs and supplier proximity.",
     "nextThoughtNeeded": true,
     "thoughtNumber": 3,
     "totalThoughts": 8
   }
   

4. 修订供应商：

   {
     "sessionId": "<sessionId>",
     "thought": "Revised: Switch battery supplier to Supplier W (Japan) for better quality, despite 10% higher cost.",
     "nextThoughtNeeded": true,
     "thoughtNumber": 2,
     "totalThoughts": 8,
     "isRevision": true,
     "revisesThought": 2
   }
   

5. 探索替代物流方案（分支）：

   {
     "sessionId": "<sessionId>",
     "thought": "Alternative: Use air freight for distribution to Europe to ensure 7-day delivery.",
     "nextThoughtNeeded": true,
     "thoughtNumber": 4,
     "totalThoughts": 8,
     "branchFromThought": 3,
     "branchId": "air_freight"
   }
   

6. 规划库存：

   {
     "sessionId": "<sessionId>",
     "thought": "Plan inventory: Maintain 20,000 units in regional warehouses (USA, Europe, Asia) with just-in-time delivery.",
     "nextThoughtNeeded": true,
     "thoughtNumber": 5,
     "totalThoughts": 8
   }
   

7. 降低风险：

   {
     "sessionId": "<sessionId>",
     "thought": "Mitigate risks: Dual-source microchips and maintain 15% buffer inventory for supply disruptions.",
     "nextThoughtNeeded": true,
     "thoughtNumber": 6,
     "totalThoughts": 10,
     "needsMoreThoughts": true
   }
   

8. 设置时间线：

   {
     "sessionId": "<sessionId>",
     "thought": "Set timeline: Supplier contracts by Month 1, manufacturing by Month 3, distribution by Month 4.",
     "nextThoughtNeeded": false,
     "thoughtNumber": 7,
     "totalThoughts": 10
   }
   

提示：

• 会话 ID：首次查询后保存 sessionId，以供后续查询使用。
• Claude Desktop 格式：如有需要，在 JSON 前添加：

  POST http://localhost:8001/tool/sequential_thinking
  

  示例：

  POST http://localhost:8001/tool/sequential_thinking
  {
    "thought": "Define objective: Plan a cost-efficient supply chain for a new smartwatch, ensuring global delivery within 5 months.",
    "nextThoughtNeeded": true,
    "thoughtNumber": 1,
    "totalThoughts": 8
  }
  

• 自定义：修改 thought 内容以适用于其他供应链（例如，食品、制药）。食品行业示例：

  {
    "thought": "Define objective: Plan a cold-chain supply chain for fresh produce, ensuring delivery within 48 hours.",
    "nextThoughtNeeded": true,
    "thoughtNumber": 1,
    "totalThoughts": 8
  }
  

Leave Manager MCP 服务

• 端点：http://localhost:8000
• 用途：使用 MCP 通过模拟数据库（employee_leaves.json）管理员工休假。
• 示例查询：
  • 查看休假余额：

    {
      "employee_id": "E001"
    }
    

    发送至 http://localhost:8000/tool/get_leave_balance。
  • 申请休假：

    {
      "employee_id": "E001",
      "leave_dates": ["2025-06-01", "2025-06-02"]
    }
    

    发送至 http://localhost:8000/tool/apply_leave。
  • 获取休假历史：

    {
      "employee_id": "E001"
    }
    

    发送至 http://localhost:8000/tool/get_leave_history。

扩展项目

• Sequential Thinking 持久化：添加 JSON 或数据库存储，以保存供应链计划，类似于 employee_leaves.json。
• Claude Desktop 自动化：创建脚本来管理 sessionId 并简化查询输入。
• 可视化：根据 Sequential Thinking 数据生成供应链流程图或时间线。
• 指标：增强 sequential_thinking，根据思考内容计算成本或交付周期。