Ldap MCP

🚀 LDAP MCP 服務器

LDAP MCP 服務器通過模型上下文協議（MCP）公開 LDAP 目錄，使 MCP 客戶端能夠使用標準工具/資源工作流執行常見的目錄搜索和 CRUD 操作。

🚀 快速開始

構建與測試

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 可打印完整的標誌和環境變量列表。

✨ 主要特性

• 通過 MCP 工具搜索、檢索、添加、修改和刪除 LDAP 條目。
• 可選的只讀模式，限制 MCP 客戶端只能進行安全操作。
• 支持 StartTLS 升級、LDAPS 端點和可配置的 TLS 驗證。
• 為目錄根 DSE 和按 DN 指定的任意條目提供內置的 MCP 資源。
• 支持優雅關閉處理和自動 LDAP 重連邏輯。

📦 安裝指南

環境要求

• Go 1.24 或更高版本
• 能夠訪問 LDAP 服務器（如 OpenLDAP、Active Directory 等）
• 支持 SSE 傳輸的 MCP 客戶端（例如 Claude Desktop）

💻 使用示例

MCP 工具與資源

工具

• search_entries：執行帶有分頁、範圍選擇、別名引用和大小限制的 LDAP 搜索。
• get_entry：按可分辨名稱獲取單個條目。
• add_entry：創建新條目（需要 -read-write 模式）。
• modify_entry：應用屬性修改（需要 -read-write 模式）。
• delete_entry：刪除條目（需要 -read-write 模式）。

資源

• ldap://root-dse：以 JSON 格式返回目錄根 DSE。
• ldap://entry/{dn}：在提供 DN 時獲取特定條目。

🔧 技術細節

• LDAP 客戶端包裝器（internal/ldapclient）管理連接重用、StartTLS 協商以及在傳輸錯誤時自動重連。
• MCP 工具處理程序（internal/tools）在調用 LDAP 操作之前會驗證輸入；例如，page_size 參數會被限制在分頁結果控件使用的 uint32 範圍內。
• 使用 gofmt 格式化 Go 源代碼，並在依賴項更改時通過 go mod tidy 保持模塊依賴項的整潔。