使用说明内容（Markdown格式）

Wrangler MCP 服务器

• 简介

  • Wrangler MCP 服务器是一套基于 Model Context Protocol 的后端服务，面向 LLM 客户端提供标准化的“资源管理、工具执行与提示渲染”能力。它通过 JSON-RPC 与客户端通讯，支持会话管理、能力声明以及多种传输协议（如标准输入输出、服务器发送事件、WebSocket 等）。核心功能包括对 Issue、Session 等资源的 CRUD 与查询工具，以及会话编 orchestration 所需的工具集。

• 主要功能点

  • 资源与工具管理：内置 16 个 MCP 工具，覆盖事项、规格、标签、元数据、项目等的创建、读取、更新、删除、搜索和分组等能力。
  • 会话与工作流编排：提供 session_start、session_phase、session_checkpoint、session_complete、session_get 等工具，支持会话的初始化、阶段切换、恢复点和结束状态记录。
  • 资源存储与元数据：使用本地文件系统作为持久化存储，维护 .wrangler 目录结构、issues/specifications/ideas 等资源，以及 session 的上下文、审计日志和检查点。
  • 兼容多种传输：默认通过標準输入输出（stdio）与 Claude Desktop 等 MCP 客户端进行通信，未来可扩展为 SSE、WebSocket 等传输。

• 安装步骤

  • 1. 克隆仓库并进入项目目录。
  • 2. 安装依赖（例如 npm install）。
  • 3. 构建产物（如 npm run build，若有构建脚本），产出 mcp/dist 等可执行文件。
  • 4. 运行服务器（下方给出启动配置示例；实际环境可通过 CLI、脚本或 Claude 插件系统启动）。
  • 5. 根据需要设置工作区根目录、提供者等环境变量（如 WRANGLER_WORKSPACE_ROOT、WRANGLER_ISSUE_PROVIDER 等），以定制资源存放位置和行为。

• 服务器配置说明

  • 服务器名称（server name）：wrangler-tools
  • 启动命令（command）：node
  • 启动参数（args）：["dist/index.js"]，或你构建产物的入口文件
  • 说明：此配置用于 MCP 客户端在启动时了解如何启动服务器进程、以及服务器的名称和版本等元信息。客户端本身不需要此信息来执行工具调用，但可用于发现和连接对应的 MCP 服务器。

• 基本使用方法

  • 启动后，LLM 客户端可通过 JSON-RPC 向服务器发送请求来读取资源、执行工具、查询或运行会话任务。调用工具需要提供工具名称和参数，服务器会返回结构化的文本内容以及可选的元数据，方便后续上下文组织与策略决策。
  • 典型工作流包括：创建 Issue、列出/搜索 Issue、启动一个实现会话（session_start）、在实现过程中的阶段性推进（session_phase）、保存恢复点（session_checkpoint）以及最终完成（session_complete）。
  • 开发者可通过 README 和文档了解各个工具的输入输出结构，以及如何将返回的 metadata 用于后续的上下文维护。

• 备注

  • 该实现包含 TypeScript/JavaScript 版本的服务器端代码、编译输出（dist 目录下的 JS/类型定义）、以及用于 Markdown 存储的本地提供者实现。
  • 服务器通过环境变量可定制工作区、资源提供者类型、以及 issue 的默认存放位置等，从而适配本地开发与集成场景。