项目简介

本项目是Morphik数据库的MCP(Model Context Protocol)服务器实现,旨在使大型语言模型(如Claude)能够通过标准协议与Morphik数据库进行交互,实现知识检索和文档管理。它作为一个中间层,将LLM的请求转换为对Morphik API的调用,并将结果格式化后返回给LLM。

主要功能点

  • 文档摄取: 允许将文本或文件内容导入到Morphik数据库中,构建您的知识库。
  • 文档检索: 支持通过语义搜索查询Morphik数据库,检索与问题最相关的文档片段(Chunks)或完整文档。
  • 文档查询: 利用检索到的文档内容作为上下文,辅助LLM生成更准确和有针对性的回答。
  • 文档管理: 提供列出、查看详细信息和删除Morphik数据库中现有文档的功能。

安装步骤

推荐使用 'npx' 或全局安装方式,这两种方法最为便捷:

  1. 使用 npx(推荐):

    • 连接到本地 Morphik 服务器:
      npx morphik-mcp
    • 连接到 Morphik 云平台(请替换为您实际的平台地址):
      npx morphik-mcp --uri=https://api.morphik.ai
  2. 全局安装:

    • 安装命令行工具:
      npm install -g morphik-mcp
    • 连接到本地 Morphik 服务器:
      morphik-mcp
    • 连接到 Morphik 云平台(请替换为您实际的平台地址):
      morphik-mcp --uri=https://api.morphik.ai

服务器配置

MCP服务器主要供MCP客户端(如支持MCP的LLM应用程序)使用。配置时,您需要告诉客户端如何启动这个Morphik MCP服务器进程。通常,这需要提供服务器的启动命令 (command) 及其所需的参数 (args)

基于上述安装方式,典型的配置信息如下:

  • 服务器名称 (server name): 您可以自定义一个名称,例如 'morphik-local' 或 'morphik-cloud'。
  • 启动命令 (command): 如果使用 'npx',命令是 'npx';如果全局安装,命令是 'morphik-mcp'。
  • 命令参数 (args): 这是一个参数列表。
    • 对于 'npx morphik-mcp':参数通常是 '["-y", "morphik-mcp"]'。
    • 对于 'npx morphik-mcp --uri=...':参数通常是 '["-y", "morphik-mcp", "--uri=您平台的URI"]'。
    • 对于全局安装的 'morphik-mcp':参数通常是 '[]' (无参数,连接本地) 或 '["--uri=您平台的URI"]'。

请根据您使用的MCP客户端的要求,将其配置中关于外部MCP服务器的部分,填写您选择的启动命令和对应的参数。例如,在Claude Desktop中,这会是在其配置文件中添加一个服务器条目。

基本使用方法

服务器启动并由MCP客户端成功连接后,LLM客户端(如Claude)将自动检测到Morphik MCP服务器提供的工具能力。在与LLM的对话中,当用户提出的问题或需求涉及文档检索、信息查询或文档管理时,LLM会根据其内置逻辑判断是否需要调用Morphik MCP服务器提供的工具(例如 'retrieve-chunks'、'ingest-text' 等)。您可以通过与LLM进行自然语言对话来利用这些功能。

信息

分类

数据库与文件