BriefDesk 本地化上下文服务集成

关键词

GmailGoogle Drive本地AI上下文工具执行本地化数据检索

使用说明（Markdown 格式）

  • 项目简介
    • BriefDesk 是一个面向本地环境的上下文服务体系，提供可扩展的资源、工具和提示模板管理，以及与外部工具的对接能力。核心组件包括 Gmail MCP、Google Drive MCP 等服务，以及一个用于聚合和管理的主控入口，帮助本地的 LLM 客户端高效获取上下文信息。
  • 主要功能点
    • 资源管理：提供对历史记录、日历、文档等资源的读取与检索能力
    • 工具注册与执行：通过 MCP 服务器暴露外部服务的调用入口，LLM 可通过工具调用实现外部功能
    • Prompt 定义与渲染：支持自定义和渲染的提示模板，提升与 LLM 的对话模式
    • JSON-RPC 通信：服务器通过标准的 JSON-RPC 协议与客户端交互，包含请求、响应和通知
    • 会话管理与认证：包含多源认证、会话状态和错误处理机制
    • 本地传输协议：支持 Stdio、HTTP/本地 Socket 等传输形式（仓库中实现了基于 MCP 的多服务端传输能力）
  • 安装步骤
    1. 克隆仓库并进入项目目录
    2. 按需搭建 Gmail、Drive 等 MCP 服务，参考各 MCP 服务中的 README 进行授权与启动
    3. 启动主控端（Search Hub/服务网关），确保本地端口可访问：
      • 主控服务用于与 MCP 服务对接、执行查询与聚合上下文
    4. 如需使用 Gmail 或 Drive 的 MCP，请按对应模块的身份验证流程完成 OAuth 授权
  • 服务器配置（示例，需给 MCP 客户端提供启动配置） 说明：以下 JSON 配置用于 MCP 客户端连接本仓库的 MCP 服务端（gmail 与 drive 为核心服务）的启动信息。字段含义：name 为服务标识，command 为启动命令，args 为传递给命令的参数。 服务器配置示例（JSON） { "mcpServers": { "gmail": { "name": "briefdesk-gmail-mcp", "command": "node", "args": ["gmail-mcp/dist/index.js"] }, "drive": { "name": "briefdesk-gdrive-mcp", "command": "node", "args": ["gdrive-mcp/dist/index.js"] } } }
  • 基本使用方法
    • 运行后端：启动 Gmail 与 Drive 的 MCP 服务器，确保 OAuth 流程完成，令牌可用
    • 通过本地客户端或前端 UI 访问 MCP 服务，发起资源查询、工具调用与提示获取
    • 使用者可在设置中调整模型、选择需要的源（Slack/Jira/Confluence/Gmail/Drive 等）以及 Prompts
    • 通过中心入口实现对多源上下文的聚合与 AI 生成（AI Brief、跨源预取等）
  • 额外说明
    • 本地化部署强调私有数据环境，所有数据处理在本地进行，避免外部传输
    • 如需扩展新的 MCP 服务，只需实现对应的 Tool 定义与 MCP 服务端逻辑，并在主控端注册即可

服务器信息

访问项目