lingti-bot MCP 服务器

关键词

本地资源管理系统工具对话上下文本地AI助手多平台集成

  • 项目简介

    • lingti-bot 是一个遵循 MCP（Model Context Protocol）的服务器端实现，旨在把本地系统资源、工具和交互模板暴露给接入的 LLM 客户端，便于在本地或私有环境中构建强大的人机协作能力。
    • 服务器通过 MCP 的标准请求/响应格式进行通信，核心职责包括：资源读取、工具注册与执行、以及 Prompt 模板的定义与渲染。
    • 服务器实现了多种传输方式的基础能力（本仓库默认通过 stdio 进行 MCP 通信，未来可拓展为 SSE/WebSocket 等传输），并内置会话管理和能力声明。

  • 主要功能点

    • MCP 服务器核心：遵循 MCP 协议，处理资源、工具与 Prompts 的请求/响应。
    • 资源管理与数据访问：提供对本地文件、系统信息等资源的访问。
    • Tools（工具集）：40+ 本地系统工具，涵盖文件、Shell、系统信息、进程、网络、日历、提醒、备忘、天气、搜索、剪贴板、截图、音乐等。
    • Prompt 定义与渲染：支持可自定义的对话模板，结合历史上下文进行多轮对话。
    • 会话与记忆：对话历史、上下文记忆与模型选择进行管理。
    • 多平台网关与集成：内置路由、支持 Slack、Feishu、WeCom、Telegram、Discord、等外部平台对接，提供消息路由能力。
    • 客户端无缝接入：通过 MCP 客户端（ Claude Desktop、Cursor 等）可快速接入，按 MCP 标准进行资源、工具与 Prompts 的访问。

  • 安装与运行步骤

    • 编译与运行
      • 使用 Go 构建：在仓库根目录执行构建后获得可执行二进制，然后执行 lingti-bot serve 启动 MCP 服务器（默认使用 stdio 传输）。
    • 快速启动（示例）
      • 直接运行二进制：lingti-bot serve
      • 典型用法场景：MCP 客户端将配置与服务器进行对接，后续通过 MCP 请求对本地资源、工具进行访问与执行。

  • 服务器配置（MCP 客户端需要的最小信息） 下列信息用于 MCP 客户端注册一个服务器，确保客户端能通过 MCP 连接到服务器并进行资源、工具与模板的调用。请将以下信息以 JSON 格式提供给客户端配置系统： { "server_name": "lingti-bot", "command": "/path/to/lingti-bot", "args": ["serve"] } 说明：

    • server_name：MCP 服务器的唯一名称，这里为 lingti-bot，确保客户端能够识别该服务器。
    • command：可执行 MCP 服务器的二进制路径，需指向 lingti-bot 的可执行文件。
    • args：启动参数，这里为 ["serve"]，表示以 MCP 服务器模式启动（通过 stdio 传输）。 注：MCP 客户端本身不需要实现服务器端逻辑，它只需要提供上述配置信息以便连接与对话。服务器与客户端之间通过 JSON-RPC 规范进行请求与响应。

  • 基本使用方法

    • 启动服务器：在目标环境执行 lingti-bot serve（或在打包后的二进制路径上执行相同命令）。
    • 连接客户端：使用 Claude Desktop、Cursor 或其他 MCP 客户端，将 server_name 设置为 lingti-bot，且提供上述启动命令和参数的配置信息，完成对 MCP 服务器的对接。
    • 运行后，客户端即可通过 MCP 请求读取资源、调用工具、获取 Prompt 模板等；服务器端负责处理请求并返回相应结果。

  • 注意事项

    • 本实现包含完整的 MCP 服务端能力、工具实现以及多平台网关集成，确保在本地环境下能提供稳定的上下文与工具服务。
    • 生产环境建议结合安全控制（如认证、传输加密、最小化权限等）使用，并遵循仓库中的安全注意事项。

  • 参考命名与版本

    • 项目名称：lingti-bot
    • MCP 服务器版本信息：服务器实现版本号与 ldflags 绑定，当前版本号与仓库示例保持一致。

服务器信息

访问项目