Local Deep MCP Server

关键词

Model Context ProtocolResources managementTools registryPrompt templatesJSON-RPCWebSocket

使用说明

  • 项目简介
    • Local Deep MCP Server 是一个面向 LLM 客户端的后端服务，按照 Model Context Protocol（MCP）定义，向 LLM 提供上下文信息、可访问的资源、可授权的外部工具以及可渲染的提示模板。通过 JSON-RPC 的请求/响应模式进行交互，支持多种传输通道，方便在本地环境中搭建安全、可扩展的上下文服务。
  • 主要功能点
    • 资源管理（Resources）：托管并提供对外的数据资源与数据访问能力，LLM 可以按需读取、索引或查询资源。
    • 工具注册与执行（Tools）：注册并暴露外部功能，LLM 可以通过 MCP 调用这些工具以完成复杂任务。
    • Prompt 模板（Prompts）：定义、渲染和提供可定制的提示模板，支持多种对话模式与交互流程。
    • 会话与能力声明：对话会话管理、能力声明、以及对客户端能力的自描述，便于自适应的上下文提供。
    • 传输协议支持：支持 STDIO、SSE、WebSocket 等传输方式，灵活适配不同客户端场景。
    • 安全与可扩展性：设计了安全边界、可扩展的资源与工具注册机制，便于按需扩展与安全控制。
  • 安装与运行（简要要点）
    • MCP 模块可通过本仓库的扩展选项安装，例如通过本地包的 MCP extras 来启用 MCP 相关支持。
    • 启动 MCP 服务器后，服务器将暴露一个标准化的接口，客户端无需关心内部实现，只需通过 MCP 协议进行 JSON-RPC 通信即可。
  • 服务器配置（针对 MCP 客户端必须的最小信息）
    • 配置信息以 JSON 格式，包含以下字段（说明性描述，不提供具体代码）：
      • server name（服务器名称）
        • 例如：local-deep-research-mcp
      • command（启动命令）
        • 例如：运行 MCP 服务的可执行文件或入口模块名
      • args（启动参数）
        • 例如：包含传输协议选择、端口、数据目录等的参数列表
    • 说明：客户端配置无需是 MCP 服务器端的实现细节，客户端只需要知道服务器的名称、启动命令和参数，以便从管理端或部署脚本对接和注册。实际与 MCP 服务的交互通过 MCP 协议定义的请求/响应进行。
  • 基本使用方法
      1. 启动 MCP 服务器：在本地环境按仓库提供的 MCP 扩展选项启动服务器，确保资源、工具与提示模板已经注册到服务器中。
      1. 连接客户端：通过 JSON-RPC 的方式，使用 STDIO、SSE 或 WebSocket 之一建立与服务器的通信通道，发送读取资源、执行工具、获取 Prompt 的请求。
      1. 发送请求/接收响应：客户端向 MCP 服务器发起请求，服务器返回标准的 JSON-RPC 响应或必要的通知，完成资源访问、工具执行及提示渲染等工作。
      1. 会话与安全：服务器负责会话管理与能力声明，必要时结合你们的安全策略进行访问控制与审计。

服务器信息

访问项目