使用说明

项目简介 Concierge MCP Server 是一个完整的 MCP 服务器框架，旨在通过标准化的 JSON-RPC 交互向大型语言模型客户端提供上下文信息和功能。它包含资源（Resources）管理、工具（Tools）注册与执行、Prompt 模板（Prompts）的定义与渲染，以及面向不同传输协议的会话管理能力，帮助将后端服务以可扩展、可控的方式暴露给模型驱动的工作流。
主要功能点
- 资源与工具托管：统一管理服务资源，注册并渲染可被 LLM 调用的工具入口。
- 工具执行与上下文传递：LLM 调用工具时，后端执行并在全局/局部状态中维护上下文。
- Prompt 模板渲染：提供 Comprehensive、Brief、State Input 等多种提示模板渲染，便于不同的交互模式。
- 会话与状态管理：内置会话管理、全局状态与阶段状态的持久化与版本历史，支持跨阶段数据传递策略（ALL/NONE/自定义字段）。
- MCP 适配器与协议实现：提供 MCP 协议适配器，允许客户端以 MCP 风格查询工具并执行工具调用。
- 多传输与 JSON-RPC 支持：设计用于扩展的传输层与 JSON-RPC 通信风格，兼容不同部署场景。
安装步骤
- 1. 安装依赖并获取源码（推荐通过包管理器/源码安装）。
- 1. 安装与编译后端组件，使 MCP 服务器可运行。
- 1. 根据需要选择内存型或数据库型状态管理（内存 InMemoryStateManager 即可本地开发使用，PostgreSQLStateManager 提供生产就绪能力）。
- 1. 启动服务器并绑定到客户端暴露的入口。
- 1. 使用 MCP 客户端（如 MCP 客户端工具或自定义 CLI）连接并测试资源、工具、Prompts 的暴露与调用。
服务器配置说明（JSON，供 MCP 客户端使用）说明：以下字段用于 MCP 客户端在配置时连接服务器并执行初始化。具体键名与数值可根据部署环境调整。 { "server_name": "concierge-mcp-server", "command": "start_mcp_server", "args": { "host": "0.0.0.0", "port": 8080, "config_path": "configs/default.yaml", "state_manager": "InMemoryStateManager" // 或 "PostgreSQLStateManager" 等实现类名 } // 该配置仅用于描述性示例，实际客户端不需要 }
基本使用方法
1. 启动服务器
  - 在服务端执行上述配置或按项目文档提供的启动命令启动 MCP 服务器。
  - 服务器启动后应对外暴露 JSON-RPC/HTTP/WebSocket 等接口，供 MCP 客户端访问。
2. 客户端交互
  - 使用 MCP 客户端向服务器发送方法调用（method_call）、阶段切换（stage_transition）等请求，并接收结构化 JSON 响应。
  - 客户端在需要时接收“Provide required state”型提示，并提交 state_input 以完成缺失的前置条件。
3. 运行与调试
  - 通过日志与历史快照（state history）验证状态在跨阶段传递中的正确性。
  - 使用 PostgreSQLStateManager 的生产配置进行持久化测试，确保历史和并发会话的隔离性。

关键词

信息