使用说明

项目简介

Morphik MCP服务器是一个为Morphik多模数据库系统设计的Model Context Protocol (MCP) 服务器实现。它允许Claude和其他兼容MCP的AI助手与Morphik数据库进行交互，核心功能是作为桥梁，让LLM能够利用Morphik数据库中的文档资源进行知识检索、问答和管理。

主要功能点

文档知识库连接: 连接到Morphik数据库（本地或云端），作为LLM访问知识库的入口。
文档内容摄取 (Ingestion): 允许LLM通过工具调用，将文本和文件内容添加到Morphik数据库中，扩展知识库。
文档检索 (Retrieval): 支持LLM根据用户查询，从Morphik数据库中检索相关的文档片段 (chunks) 或完整文档，为LLM提供上下文信息。
文档问答 (Querying): 利用LLM能力，基于检索到的文档内容回答用户问题，实现增强型问答。
文档管理 (Management): 提供文档的列表、获取和删除功能，方便LLM对知识库进行维护。
图像内容支持: 能够处理和返回图像内容，并针对Claude的图像大小限制进行了优化。

安装步骤

环境准备: 确保你能够访问Morphik服务器。你可以选择：
- 运行在 'localhost:8000' 的本地Morphik服务器
- Morphik云平台 (需要URI)

安装 Morphik MCP 服务器: 推荐使用 'npx' 直接运行，无需全局安装。你也可以选择全局安装或本地开发方式。

选项 1: 使用 npx 运行 (推荐)

# 连接到本地 Morphik 服务器
npx morphik-mcp

# 连接到 Morphik 云平台 (替换为你的实际 URI)
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

选项 3: 本地开发 (如果你希望修改代码)

# 克隆仓库
git clone https://github.com/morphik-org/morphik-npm-mcp.git
cd morphik-npm-mcp

# 安装依赖
npm install

# 构建项目
npm run build

# 启动服务器 (本地 Morphik)
npm start

# 启动服务器 (Morphik 云)
node build/index.js --uri=https://api.morphik.ai

服务器配置

要将 Morphik MCP 服务器与 MCP 客户端（例如 Claude Desktop）连接，你需要配置客户端的 MCP 服务器设置。以下是针对 Claude Desktop 的配置示例，你需要将配置添加到 Claude Desktop 的配置文件中。

Claude Desktop 配置示例 (JSON 格式)

{
  "mcpServers": {
    "morphik-local": {
      "serverName": "morphik-local",  // 服务器名称，可以自定义
      "command": "npx",             // 启动服务器的命令，这里使用 npx
      "args": ["-y", "morphik-mcp"]   // 命令参数，运行 morphik-mcp，连接本地 Morphik 服务器
    },
    "morphik-cloud": {
      "serverName": "morphik-cloud", // 服务器名称，可以自定义
      "command": "npx",             // 启动服务器的命令，这里使用 npx
      "args": ["-y", "morphik-mcp", "--uri=https://api.morphik.ai"] // 命令参数，运行 morphik-mcp 并指定 Morphik 云平台的 URI
    }
  }
}

配置说明:

'"mcpServers"': 定义 MCP 服务器配置的根节点。
'"morphik-local"' 和 '"morphik-cloud"': 自定义的服务器名称，用于在 Claude 中标识不同的 Morphik 服务器连接。
'"serverName"': MCP 服务器的名称，客户端会显示这个名称。
'"command"': 启动 MCP 服务器的可执行命令。这里使用 'npx'，它允许你直接运行 npm 包，而无需全局安装。
'"args"': 传递给 'command' 的参数数组。
- '"-y"': 'npx' 的参数，表示自动同意执行包。
- '"morphik-mcp"': 要运行的 npm 包名称，即 Morphik MCP 服务器。
- '"--uri=https://api.morphik.ai"' (仅在 'morphik-cloud' 中): 指定 Morphik 服务器的 URI。你需要替换为你实际的 Morphik 云平台 URI。如果不指定 '--uri' 参数，服务器默认连接本地 'http://localhost:8000' 的 Morphik 服务器。

基本使用方法

配置完成后，在 Claude 等 MCP 客户端中，你将能够选择配置的 "morphik-local" 或 "morphik-cloud" 服务器。然后，你可以指示 Claude 使用以下工具与 Morphik 数据库交互：

'ingest-text': 将文本内容添加到 Morphik 知识库。
'retrieve-chunks': 根据用户查询，检索最相关的文档片段 (chunks)。这是最常用的工具，用于回答知识型问题。
'retrieve-docs': 根据用户查询，检索相关的完整文档。
'list-documents': 列出 Morphik 知识库中的文档列表。
'get-document': 获取指定 ID 的文档的详细信息。
'delete-document': 删除指定 ID 的文档。

例如，你可以对 Claude 说：

"使用 'retrieve-chunks' 工具，查询 '什么是 MCP 协议？'"
"使用 'ingest-text' 工具，将以下内容添加到知识库：'Model Context Protocol (MCP) ...'"
"使用 'list-documents' 工具，列出所有文档。"

客户端会根据你的指令调用相应的 MCP 工具，并将结果返回给你。

注意: Morphik MCP 服务器通过标准输入/输出流 (stdio) 与 MCP 客户端通信。

关键词

使用说明

信息