Mantic.sh MCP 服务端实现

关键词

LLM上下文JSON-RPC工具注册资源管理Prompts 模板

使用说明（简明易懂，确保开发者能快速上手）：

  • 项目简介 Mantic.sh 提供一个完整的 MCP（Model Context Protocol）服务器端实现，用于向支持 MCP 的 AI 客户端（如 Claude Desktop、Cursor、VS Code 及其他 MCP 客户端）提供可读取的资源、可执行的工具、以及可渲染的提示模板等服务。服务器通过 JSON-RPC 接收请求，返回资源、工具调用结果、Prompts 渲染结果等信息，并支持会话管理与能力声明，方便多轮对话和上下文传递。

  • 主要功能点

    • MCP 服务器核心：实现对 MCP 请求的处理、响应和工具调用。
    • 工具注册与执行：定义名称、输入结构、描述，支持调用本地脚本实现的工具（如 search_files、get_definition、references 等）。
    • 资源与提示管理：通过接口提供资源访问、Prompts 渲染以及上下文模板。
    • 会话管理与上下文 carryover：支持会话维持、查看历史、文件查看记录等，用于增强 LLM 的上下文信息。
    • 多传输协议支持：基于 MCP 框架，具备 STDIO 交互能力，后续可扩展为 SSE/WebSocket。
    • 安全与稳定性：使用 JSON-RPC 标准，提供参数校验、错误处理和日志输出。

  • 安装步骤

    • 克隆仓库并安装依赖（如有 package.json，执行 npm install）。
    • 构建/编译：按照仓库提供的构建脚本进行构建，产出可执行的 MCP 服务程序。
    • 启动服务器：
      • 使用仓库提供的命令行入口：运行包含 MCP 服务的 CLI，执行指令启动服务器。
      • 例如通过命令行直接启动 MCP 服务器（仓库提供了 server 子命令来启动 MCP 服务）。
    • 验证服务器启动是否正常：应输出服务器就绪信息，表示 MCP 服务已监听并可接受客户端请求。

  • 服务器配置（MCP 客户端需要的配置示例说明，JSON 描述，不包含代码块）

    • server name: mantic
    • command: node
    • args: ["path/to/your/mcp-server-entry.js", "server"]
    • 注释：这是 MCP 客户端连接 MCP 服务器所需的最小信息，表示服务器名称、启动服务器的命令以及运行参数。客户端通过读取该配置并启动服务器进程，与 MCP 服务器进行 JSON-RPC 通信。实际的启动入口可以使用仓库提供的 CLI 入口（例如通过 npx mantic.sh@latest server），也可以自行编译后以 node 运行对应的入口文件。
    • 说明：客户端维护与服务器的连接、请求/响应的序列化、能力声明、以及工具的注册与执行调用等，服务器端负责如何处理这些请求并返回结果。

  • 基本使用方法

    • 启动后，客户端发送 JSON-RPC 请求，例如读取资源、调用工具、获取 Prompt 等。
    • 客户端可以通过调用工具（如 search_files、get_definition、references）来获得文件列表、定义位置、引用等信息，再结合返回的上下文进行后续推理和交互。
    • 如需进行零查询/主动上下文场景，可让客户端触发 Zero-Query 模式，服务器将返回当前工作上下文与推荐操作。
    • 会话管理：如需跨查询保持上下文，请使用会话相关的工具和参数，服务器将跟踪查看历史和 boost。
    • 服务器端与客户端的通信遵循 MCP 规范的 JSON-RPC 请求/响应格式，便于跨语言实现与互操作。

  • 使用前提与注意事项

    • 确保你的运行环境支持 Node.js/当前实现所需的运行时环境。
    • 客户端在对接 MCP 时，需要了解服务器暴露的工具名称与输入结构，以正确构造请求参数。
    • 为了安全与稳定，请按需开启/关闭技能（如语义重排、会话等），并对并发与超时进行合理配置。

  • 参考说明

    • 该仓库包含完整的 MCP 服务端实现代码，具备工具注册、请求处理、以及会话和上下文管理等能力，能够对外提供 MCP 标准的资源、工具、和 Prompts 服务。

服务器信息

访问项目