Quern MCP 服务器

关键词

本地调试移动开发JSON-RPC上下文服务工具执行

使用说明

  • 项目简介
    • Quern 是一个本地调试服务器集合，包含一个基于 Model Context Protocol (MCP) 的服务器端实现，用于向 LLM 客户端（如 Claude Code、Cursor 等）提供结构化的上下文信息、资源访问、工具执行等能力，便于在本地进行 AI 辅助的移动应用开发与调试。
  • 主要功能点
    • 资源(Resources)托管与访问：提供数据资源的统一管理与读取能力
    • 工具(Tools)注册与执行：允许 LLM 调用外部功能和脚本
    • Prompt 模板(Render Prompts)：定义/渲染与 LLM 交互相关的提示模板
    • JSON-RPC 通信：前后端通过标准化的 JSON-RPC 进行请求和响应
    • 会话与能力声明：服务端维护会话、能力声明，按需提供能力
    • 多传输协议支持：如 Stdio、SSE、WebSocket 等传输，便于不同环境接入
  • 安装步骤
    • 获取代码并安装依赖
      • 克隆仓库并进入项目目录
      • 在根目录安装所需依赖，或者进入 mcp 子目录执行对应的安装与构建步骤
    • 构建 MCP 服务器
      • 进入 mcp 目录，执行构建命令以生成可执行的 MCP 服务
    • 注册 MCP 服务
      • 运行 quern mcp-install 以在客户端（如 Claude Code）的配置中注册 MCP 服务
    • 启动 Quern 服务
      • 启动 Quern 作为后台守护进程，确保 MCP 服务与本地服务协同工作
  • 服务器配置（MCP 客户端配置说明） 说明：MCP 客户端需要配置一个 MCP 服务器连接，但仓库中客户端的具体配置通常由 MCP 客户端在首次注册时自动建立连接。以下描述仅作为参考，实际连接信息由 MCP 客户端通过 quern mcp-install 进行注册与发现。在本仓库实现中，MCP 服务器由 Quern 提供并通过 state.json 进行发现。
    • server_name: quern-mcp
    • command: 指向 MCP 服务器的执行可用路径（由构建输出产生，通常在 mcp 目录构建后得到可执行入口）
    • args: 根据 MCP 服务的实现，常见参数可能包含端口、传输协议等，例如 ["--port","9100","--transport","stdio|sse|ws"]，具体请参考构建产物和运行时参数 注释：MCP 客户端无需手动编写复杂配置；在本仓库中，quern mcp-install 会把 MCP 服务器信息注册到客户端配置中，客户端直接通过注册信息发现并连接。
  • 基本使用
    • 启动 Quern 服务（确保 MCP 服务器随之可用）→ 使用 LLM 客户端通过 MCP 接口请求资源、调用工具、渲染 Prompts
    • 使用 MCP 工具集成工作流：例如 ensure_server、query_logs、proxy 流量捕获等工具，以实现对后端资源的访问和外部功能的组合调用
    • 通过 JSON-RPC 规范与客户端进行交流，服务器端负责会话管理和能力声明

服务器信息

访问项目