DataBridge

🚀 Morphik MCP 服务器

Morphik MCP 服务器是 Morphik 多模态数据库的 Model Context Protocol (MCP) 服务端实现。它能让 Claude 及其他与 MCP 兼容的 AI 助手（如其他工具）与 Morphik 数据库系统进行交互，为数据处理和查询提供便利。

🚀 快速开始

概述

此 MCP 服务器允许 Claude 和其他与 MCP 兼容的 AI 助手（如其他工具）与 Morphik 数据库系统交互，支持以下功能：

• 文档摄入（文本和文件）
• 文档检索（根据查询的相关性）
• 带有 LLM 动态完成的文档查询
• 文档管理（列出、获取、删除）
• 文件系统导航和从路径中上传文件

先决条件

你需要访问以下任意一个：

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

📦 安装指南

选项 1：直接通过 npx 运行（推荐）

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

# 连接到 Morphik 云平台（请将 URI 替换为你实际的地址）
npx morphik-mcp --uri=https://api.morphik.ai

# 指定文件操作允许的目录（逗号分隔）
npx morphik-mcp --allowed-dir=~/Documents,~/Downloads

选项 2：全局安装

npm install -g morphik-mcp

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

# 连接到 Morphik 云平台
morphik-mcp --uri=https://api.morphik.ai

# 指定文件操作允许的目录
morphik-mcp --allowed-dir=~/Documents,~/Downloads

选项 3：本地开发

# 构建项目
npm run build

# 运行测试
npm test

# 手动运行测试
npm run test:manual

📚 详细文档

在 Claude Desktop 中配置

如何在 Claude Desktop 中配置：

# 配置示例
CLAUDE_CONFIG_PATH=~/.config/claude/config.json

提供的工具

文档管理

• ingest-text：摄入文本内容。
• ingest-file：从文件中摄入内容。
• list-documents：列出所有文档。
• get-document：获取指定文档的内容。

查询

• query：根据查询返回相关文档。
• execute：执行动态代码以回答问题。

文档管理

• add-to-prompt：将文档添加到提示历史中。
• remove-from-prompt：从提示历史中删除文档。
• clear-prompt：清除所有提示历史。

文件操作安全

出于安全考虑，文件操作仅限于启动服务器时显式允许的目录。如果未指定任何目录，默认只允许访问用户的主目录。服务器会对所有文件路径进行验证，确保它们在允许的目录内，并防止 symlink 逃逸攻击。

开发

构建项目

npm run build

运行测试

npm test

手动运行测试

npm run test:manual

📄 许可证

ISC