🚀 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