Marklogic MCP

🚀 MCP MarkLogic サーバー

このサーバーは、MarkLogic 用に実装された Model Context Protocol (MCP) サーバーです。MCP ツールを通じて MarkLogic データベースとやり取りすることができます。

🚀 クイックスタート

このサーバーを使用することで、MCP ツールを介して MarkLogic データベースとのやり取りが可能になります。以下に、インストール、設定、使用方法などの手順を説明します。

📦 インストール

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