Morphik MCP

一个用于 Morphik 多模态数据库的模型上下文协议 (MCP) 服务器实现。

概述

这个 MCP 服务器允许 Claude 和其他兼容 MCP 的 AI 助手与 Morphik 数据库系统交互，从而实现：

• 文档摄取（文本和文件）
• 文档检索（按查询相关性）
• 使用 LLM 驱动的补全进行文档查询
• 文档管理（列出、获取、删除）

先决条件

您需要访问以下任一资源：

• 在 localhost:8000 上运行的本地 Morphik 服务器，或
• Morphik 云平台

安装 & 使用

选项 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

服务器在标准输入/输出流上运行，可与 Claude 等 MCP 客户端一起使用。

在 Claude Desktop 中使用

将以下内容添加到您的 Claude Desktop 配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "morphik-local": {
      "command": "npx",
      "args": ["-y", "morphik-mcp"]
    },
    "morphik-cloud": {
      "command": "npx",
      "args": ["-y", "morphik-mcp", "--uri=https://api.morphik.ai"]
    }
  }
}

MCP 工具

服务器提供以下工具：

1. 文档摄取

• ingest-text: 将文本文档摄取到 Morphik 中
  • 参数：content, filename (可选), metadata (可选), apiKey

2. 文档检索

• retrieve-chunks: 根据查询从 Morphik 中检索相关块

  • 参数：query, filters (可选), k (可选), minScore (可选), apiKey

• retrieve-docs: 根据查询从 Morphik 中检索相关文档

  • 参数：query, filters (可选), k (可选), minScore (可选), apiKey

3. 文档查询

• query: 使用相关块作为上下文生成补全
  • 参数：query, filters (可选), k (可选), maxTokens (可选), temperature (可选), apiKey

4. 文档管理

• list-documents: 列出 Morphik 中的文档

  • 参数：skip (可选), limit (可选), filters (可选), apiKey

• get-document: 通过 ID 从 Morphik 中获取特定文档

  • 参数：documentId, apiKey

• delete-document: 通过 ID 从 Morphik 中删除文档

  • 参数：documentId, apiKey

开发

构建项目：

npm run build

运行测试：

npm test

运行手动测试：

npm run test:manual

许可证

ISC