Ldap MCP

🚀 LDAP MCP Server

LDAP MCP Serverは、Model Context Protocol (MCP) を通じてLDAPディレクトリを公開します。これにより、MCPクライアントは標準的なツール/リソースワークフローを使用して、一般的なディレクトリ検索やCRUD操作を実行できます。

🚀 クイックスタート

LDAP MCP Serverを使用することで、MCPクライアントはLDAPディレクトリに対して検索やCRUD操作を行うことができます。以下に、サーバーのビルド、テスト、実行方法を説明します。

✨ 主な機能

• MCPツールを通じて、LDAPエントリの検索、取得、追加、修正、削除が可能です。
• オプションの読み取り専用モードを使用すると、MCPクライアントは安全な操作のみを実行できます。
• StartTLSアップグレード、LDAPSエンドポイント、および構成可能なTLS検証をサポートしています。
• ディレクトリのルートDSEとDNによる任意のエントリのための組み込みMCPリソースがあります。
• グレースフルシャットダウンの処理と自動LDAP再接続ロジックが備わっています。

📦 インストール

必要条件

• Go 1.24以上
• LDAPサーバー (OpenLDAP、Active Directoryなど) へのアクセス
• SSEトランスポートに対応したMCPクライアント (例: Claude Desktop)

ビルドとテスト

cd /opt/code/github/ldap-mcp
go test ./...

現在、リポジトリにはユニットテストが含まれていないため、正常に実行されると、プロジェクトがコンパイルされ、すべての依存関係が解決されたことが確認できます。

サーバーの実行

cd /opt/code/github/ldap-mcp
go run ./cmd/server \
  -url ldap://localhost:389 \
  -bind-dn "cn=admin,dc=example,dc=com" \
  -bind-password secret

主要なフラグ:

• -addr: MCPのリッスンアドレス (デフォルトは :8080、MCP_PORT で上書き可能)。
• -url: LDAPサーバーのURL (例: ldap://host:389 または ldaps://host:636)。
• -bind-dn / -bind-password: ディレクトリにバインドするための資格情報。パスワードは LDAP_BIND_PASSWORD 環境変数でも指定できます。
• -starttls: 通常のLDAP接続をTLSにアップグレードします。ldap:// URLを使用する場合のみ有効です。
• -insecure: TLS証明書の検証をスキップします (自己署名証明書を使用したテストに便利)。
• -read-write: 追加/修正/削除ツールを有効にします。指定しない場合、サーバーは読み取り専用モードで動作します。
• -timeout: LDAPサーバーと通信する際のリクエストごとのタイムアウト (デフォルトは30秒)。

-help を使用すると、すべてのフラグと環境変数のリストを表示できます。

💻 使用例

基本的な使用法

サーバーの実行例は以下の通りです。

cd /opt/code/github/ldap-mcp
go run ./cmd/server \
  -url ldap://localhost:389 \
  -bind-dn "cn=admin,dc=example,dc=com" \
  -bind-password secret

高度な使用法

サーバーを読み書きモードで実行し、TLSアップグレードを有効にする例です。

go run ./cmd/server \
  -url ldap://localhost:389 \
  -bind-dn "cn=admin,dc=example,dc=com" \
  -bind-password secret \
  -starttls \
  -read-write

📚 ドキュメント

MCP Surface

ツール

• search_entries: ページング、スコープ選択、エイリアス参照解除、およびサイズ制限を使用してLDAP検索を実行します。
• get_entry: 識別名で単一のエントリを取得します。
• add_entry: 新しいエントリを作成します (-read-write が必要)。
• modify_entry: 属性の変更を適用します (-read-write が必要)。
• delete_entry: エントリを削除します (-read-write が必要)。

リソース

• ldap://root-dse: ディレクトリのルートDSEをJSON形式で返します。
• ldap://entry/{dn}: DNを指定すると、特定のエントリを取得します。

🔧 技術詳細

• LDAPクライアントラッパー (internal/ldapclient) は、接続の再利用、StartTLSネゴシエーション、およびトランスポートエラー時の自動再接続を管理します。
• MCPツールハンドラー (internal/tools) は、LDAP操作を呼び出す前に入力を検証します。たとえば、page_size 引数はページング結果コントロールで使用される uint32 範囲に制限されます。
• Goソースを gofmt で整形し、依存関係が変更された場合は go mod tidy でモジュールの依存関係を整理してください。