MCP MarkLogic 服务器

这是一个用于 MarkLogic 的模型上下文协议 (MCP) 服务器实现，允许您通过 MCP 工具与 MarkLogic 数据库进行交互。

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

创建文档

• 在 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