MCP MarkLogic 服务器

这是一个用于 MarkLogic 的 Model Context Protocol (MCP) 服务器实现，允许您通过 MCP 工具与 MarkLogic 数据库进行交互。

1. 该服务器提供以下操作：

创建文档

• 在 MarkLogic 中创建带有可选集合的文档
• 按 URI 读取文档
• 按 URI 删除文档
• 使用查询字符串和可选的集合过滤器搜索文档

安装

pip install mcp-marklogic

配置

服务器需要以下环境变量：

MARKLOGIC_HOST=localhost
MARKLOGIC_PORT=8000
MARKLOGIC_USERNAME=admin
MARKLOGIC_PASSWORD=admin

使用

安装并配置完成后，您可以启动服务器：

mcp-marklogic

可用工具

1. create-document

   • 在 MarkLogic 中创建新文档
   • 参数：
     • uri: 文档 URI（必需）
     • content: 作为 JSON 的文档内容（必需）
     • collections: 要将文档添加到的集合列表（可选）

2. read-document

   • 从 MarkLogic 读取文档
   • 参数：
     • uri: 文档 URI（必需）

3. delete-document

   • 从 MarkLogic 删除文档
   • 参数：
     • uri: 文档 URI（必需）

4. search-documents

   • 在 MarkLogic 中搜索文档
   • 参数：
     • query: 搜索查询字符串（必需）
     • collections: 要在其中搜索的集合列表（可选）

开发

设置

1. 克隆仓库
2. 创建并激活虚拟环境
3. 安装依赖项：

   pip install -e .
   

运行测试

pytest tests/

MarkLogic 设置

1. 确保已安装并运行了 MarkLogic 服务器
2. 如果尚未存在，在端口 8000 上创建一个 REST API 实例
3. 创建具有适当权限的用户：
   • 访问管理界面（通常是 http://localhost:8001）
   • 创建角色 python-docs-role 并赋予：
     • 角色：rest-extension-user, rest-reader, rest-writer
     • 权限：xdbc:eval, xdbc:invoke, xdmp:eval-in
   • 创建用户 python-user 并设置：
     • 密码：pyth0n
     • 角色：python-docs-role

许可证

MIT