MDDB MCP 服务端

关键词

向量检索外部工具调用资源管理配置输出

使用说明（Markdown 格式）

  • 项目简介

    • 该仓库在 MDDB 数据库系统中实现了一个 MCP（Model Context Protocol）服务器端组件。它通过 HTTP 提供 MCP 的资源与工具入口，支持对外注册工具、执行工具调用，以及输出 MCP 配置、实现对接方与 MDDB 的对话上下文服务能力。

  • 主要功能点

    • 资源托管（Resources）：提供可供 LLM 客户端访问的数据资源接口，便于资源管理和数据访问。
    • 工具注册与执行（Tools）：支持注册外部工具并由 MCP 客户端调用，Server 端负责分发、执行以及结果返回。
    • 配置输出与定制（Prompts/Config）：提供 MCP 的配置信息输出接口，以及对自定义工具的加载（包含自定义工具配置文件的加载）和默认工具集合。
    • 多协议集成与安全性结合：集成 MDDB 的认证、权限控制和日志体系，配合 MCP 的对接走向，支持后端安全策略。
    • 与 MDB 服务的整合能力：MCP 服务器通过 MDDB 的 API/内部客户端实现，与资源、向量检索、FTS、Webhook、Schema、Embedder 等能力协同工作。

  • 安装步骤

    • 获取源码并编译 MDDB 服务端（包含 MCP 模块）。
    • 启动 MDDB 服务端，开启 MCP 功能（配置中开启 MCP，同时允许对外端口暴露）。
    • MCP 服务器默认通过 MDDB 的内置 HTTP 服务提供对外入口，监听在配置的 MCP 端口（示例端口通常为 9000）。
    • 注意：MCP 客户端侧不需要包含 MCP 服务器实现的代码，只需要配置连接信息与对接参数即可。

  • 服务器配置（MCP 客户端连接信息示例）

    • 说明：以下 JSON 配置仅用于 MCP 客户端对接，描述了服务器名称、启动命令、以及命令参数。具体参数需结合实际部署的 MDDB 二进制与环境变量来确定。
    • 配置示例（JSON） { "serverName": "MDDB-MCP-Server", "command": "/path/to/mddbd", "args": [ "--http-address", "0.0.0.0:11023", "--mcp-address", "0.0.0.0:9000" ], "notes": "请将 path、地址与端口替换为实际部署时使用的可访问地址，确保 MCP 服务端已启用并暴露端口。" }

  • 基本使用方法

    • 启动与连接
      • 启动 MDDB 服务端并开启 MCP 功能。
      • MCP 客户端读取配置，使用 serverName、command 与 args 指向 MCP 服务端实例。
    • 使用流程
      • MCP 客户端请求资源清单、查询资源、调用工具、以及接收/渲染提示模板等。
      • MCP 服务端返回标准化的资源、工具及执行结果，提供可扩展的上下文服务能力。
    • 运行时注意事项
      • 关注权限控制与鉴权策略，与 MDDB 的认证/授权模块协同工作。
      • 如服务器配置中开启了自定义工具，确保自定义工具配置文件可被正确加载。

服务器信息

访问项目