ServiceDesk Plus MCP Server

MCP (Model Context Protocol) server để tích hợp với ServiceDesk Plus On-Premise với hỗ trợ đầy đủ CMDB.

🎯 Tính năng

Ticket Management

• ✅ Quản lý tickets (tạo, cập nhật, xem danh sách, xóa)
• ✅ Tìm kiếm và lọc tickets
• ✅ Quản lý comments và attachments
• ✅ Workflow automation

CMDB (Configuration Management Database)

• ✅ Configuration Items (CIs) - Quản lý servers, network devices, software
• ✅ Asset Management - Quản lý hardware, software, locations
• ✅ Software License Management - Tracking licenses, compliance
• ✅ Contract Management - Vendor contracts, SLA tracking
• ✅ Purchase Order Management - Procurement automation
• ✅ Vendor Management - Vendor relationships, contacts

Admin Management

• ✅ Site Management - Quản lý sites, locations, branches
• ✅ User Group Management - Quản lý groups, permissions, roles
• ✅ User & Technician Management - CRUD operations, role assignment
• ✅ Permission Management - Role-based permissions, access control
• ✅ Department Management - Organizational structure
• ✅ Location Management - Physical locations, rooms, floors
• ✅ System Settings - Email, notifications, system configuration

User Management

• ✅ Quản lý users và technicians
• ✅ Role-based access control
• ✅ User provisioning

Advanced Features

• ✅ Authentication với ServiceDesk Plus API
• ✅ Real-time data synchronization
• ✅ Comprehensive error handling
• ✅ Async/await for high performance
• ✅ Pagination và filtering
• ✅ Search capabilities

📦 Cài đặt

1. Cài đặt dependencies:

pip install -r requirements.txt

2. Tạo file .env với thông tin cấu hình:

SDP_BASE_URL=https://your-servicedesk-plus-instance.com
SDP_USERNAME=your_username
SDP_PASSWORD=your_password
SDP_API_KEY=your_api_key

3. Chạy MCP server:

python main.py

⚙️ Cấu hình MCP Client

Với Claude Desktop

Thêm vào file cấu hình MCP (~/.config/claude/desktop-config.json):

{
  "mcpServers": {
    "servicedesk-plus": {
      "command": "python",
      "args": ["/path/to/servicedeskplus_mcp/main.py"],
      "env": {
        "SDP_BASE_URL": "https://your-instance.com",
        "SDP_USERNAME": "your_username",
        "SDP_PASSWORD": "your_password"
      }
    }
  }
}

Với Cursor

Thêm vào file cấu hình MCP:

{
  "mcpServers": {
    "servicedesk-plus": {
      "command": "python",
      "args": ["/path/to/servicedeskplus_mcp/main.py"]
    }
  }
}

🛠️ API Endpoints

Ticket Management (15 tools)

• list_tickets - Lấy danh sách tickets với bộ lọc
• get_ticket - Lấy thông tin chi tiết ticket
• create_ticket - Tạo ticket mới
• update_ticket - Cập nhật ticket
• delete_ticket - Xóa ticket
• search_tickets - Tìm kiếm tickets
• add_ticket_comment - Thêm comment
• get_ticket_comments - Lấy comments

CMDB - Configuration Items (7 tools)

• list_configuration_items - Lấy danh sách CIs
• get_configuration_item - Lấy chi tiết CI
• create_configuration_item - Tạo CI mới
• update_configuration_item - Cập nhật CI
• delete_configuration_item - Xóa CI
• get_ci_types - Lấy loại CIs
• get_ci_relationships - Lấy relationships

Asset Management (10 tools)

• list_assets - Lấy danh sách assets
• get_asset - Lấy chi tiết asset
• create_asset - Tạo asset mới
• update_asset - Cập nhật asset
• delete_asset - Xóa asset
• get_asset_types - Lấy loại assets
• get_asset_categories - Lấy danh mục assets
• get_asset_locations - Lấy vị trí assets
• get_asset_models - Lấy model assets
• get_asset_vendors - Lấy vendor assets

Software License Management (6 tools)

• list_software_licenses - Lấy danh sách licenses
• get_software_license - Lấy chi tiết license
• create_software_license - Tạo license mới
• update_software_license - Cập nhật license
• get_software_products - Lấy software products
• get_license_types - Lấy loại licenses

Contract Management (6 tools)

• list_contracts - Lấy danh sách contracts
• get_contract - Lấy chi tiết contract
• create_contract - Tạo contract mới
• update_contract - Cập nhật contract
• get_contract_types - Lấy loại contracts
• get_contract_vendors - Lấy vendor contracts

Purchase Order Management (5 tools)

• list_purchase_orders - Lấy danh sách POs
• get_purchase_order - Lấy chi tiết PO
• create_purchase_order - Tạo PO mới
• update_purchase_order - Cập nhật PO
• get_po_statuses - Lấy trạng thái POs

Vendor Management (5 tools)

• list_vendors - Lấy danh sách vendors
• get_vendor - Lấy chi tiết vendor
• create_vendor - Tạo vendor mới
• update_vendor - Cập nhật vendor
• get_vendor_types - Lấy loại vendors

Admin Management - Sites (6 tools)

• list_sites - Lấy danh sách sites
• get_site - Lấy chi tiết site
• create_site - Tạo site mới
• update_site - Cập nhật site
• delete_site - Xóa site
• get_site_types - Lấy loại sites

Admin Management - User Groups (8 tools)

• list_user_groups - Lấy danh sách user groups
• get_user_group - Lấy chi tiết user group
• create_user_group - Tạo user group mới
• update_user_group - Cập nhật user group
• delete_user_group - Xóa user group
• get_group_types - Lấy loại groups
• get_group_permissions - Lấy permissions của group
• update_group_permissions - Cập nhật permissions cho group

Admin Management - Users & Technicians (12 tools)

• list_admin_users - Lấy danh sách admin users
• get_admin_user - Lấy chi tiết admin user
• create_admin_user - Tạo admin user mới
• update_admin_user - Cập nhật admin user
• delete_admin_user - Xóa admin user
• list_admin_technicians - Lấy danh sách admin technicians
• get_admin_technician - Lấy chi tiết admin technician
• create_admin_technician - Tạo admin technician mới
• update_admin_technician - Cập nhật admin technician
• delete_admin_technician - Xóa admin technician
• get_user_roles - Lấy user roles
• get_technician_roles - Lấy technician roles

Admin Management - Permissions (5 tools)

• get_permissions - Lấy danh sách permissions
• get_role_permissions - Lấy permissions của role
• update_role_permissions - Cập nhật permissions cho role
• get_user_permissions - Lấy permissions của user
• update_user_permissions - Cập nhật permissions cho user

Admin Management - Departments (6 tools)

• list_departments - Lấy danh sách departments
• get_department - Lấy chi tiết department
• create_department - Tạo department mới
• update_department - Cập nhật department
• delete_department - Xóa department
• get_department_types - Lấy loại departments

Admin Management - Locations (6 tools)

• list_locations - Lấy danh sách locations
• get_location - Lấy chi tiết location
• create_location - Tạo location mới
• update_location - Cập nhật location
• delete_location - Xóa location
• get_location_types - Lấy loại locations

Admin Management - System Settings (6 tools)

• get_system_settings - Lấy system settings
• update_system_settings - Cập nhật system settings
• get_email_settings - Lấy email settings
• update_email_settings - Cập nhật email settings
• get_notification_settings - Lấy notification settings
• update_notification_settings - Cập nhật notification settings

User Management (3 tools)

• list_users - Lấy danh sách users
• get_user - Lấy thông tin user
• list_technicians - Lấy danh sách technicians

Reference Data (3 tools)

• get_categories - Lấy danh mục tickets
• get_priorities - Lấy mức độ ưu tiên
• get_statuses - Lấy trạng thái tickets

🎯 Ví dụ Sử Dụng

Quản lý Infrastructure:

"Tạo Configuration Item cho server database mới 'DB-SRV-001'"
"Lấy danh sách tất cả network devices đang hoạt động"
"Tạo asset cho switch mới và gán vào data center"

Quản lý Software:

"Tạo software license cho Adobe Creative Suite với 50 licenses"
"Kiểm tra số lượng licenses còn lại cho Microsoft Office"
"Cập nhật license Adobe với ngày hết hạn mới"

Quản lý Contracts:

"Tạo contract bảo trì với vendor Dell cho 3 năm"
"Lấy danh sách contracts sắp hết hạn trong 30 ngày tới"
"Cập nhật contract Microsoft với giá trị mới"

Quản lý Procurement:

"Tạo purchase order cho 20 monitors từ vendor HP"
"Kiểm tra trạng thái purchase order PO-2024-001"
"Cập nhật PO với ngày giao hàng mới"

Quản lý Admin:

"Tạo site mới 'Branch Office Hanoi' với loại branch_office"
"Tạo user group 'IT Support Team' và gán permissions"
"Tạo admin user 'john.doe' với role technician"
"Cập nhật permissions cho role 'manager'"
"Tạo department 'Software Development'"
"Lấy danh sách tất cả locations trong site 'Headquarters'"
"Cập nhật email settings cho thông báo tickets"

📊 Tính năng Nổi Bật

• 🔄 Async/await - Hiệu suất cao với async operations
• 🛡️ Error handling - Xử lý lỗi toàn diện
• 🔐 Authentication - Hỗ trợ Basic Auth và API Key
• 📄 Pagination - Quản lý dữ liệu lớn hiệu quả
• 🔍 Filtering - Bộ lọc linh hoạt cho tất cả endpoints
• 📝 Validation - Kiểm tra dữ liệu đầu vào
• 📊 Logging - Ghi log chi tiết cho debugging
• ⚙️ Configuration - Quản lý cấu hình linh hoạt

🚀 Lợi Ích

1. Centralized Management - Quản lý tập trung toàn bộ IT infrastructure
2. Compliance Tracking - Theo dõi compliance với licenses và contracts
3. Asset Lifecycle - Quản lý toàn bộ lifecycle của assets
4. Vendor Management - Quản lý hiệu quả các vendor relationships
5. Procurement Automation - Tự động hóa quy trình mua sắm
6. Reporting & Analytics - Báo cáo và phân tích dữ liệu CMDB
7. AI Integration - Tích hợp AI để tự động hóa các tác vụ

📚 Tài liệu Chi tiết

• 📖 Hướng dẫn sử dụng chi tiết
• 🏗️ Tính năng CMDB
• 🧪 Test Connection

🔧 Troubleshooting

Chạy script test để kiểm tra kết nối:

python test_connection.py

Kiểm tra logs để debug:

python main.py --verbose

---

Version: 2.0.0
Total Tools: 100+ tools
CMDB Support: ✅ Full Support
Admin Management: ✅ Full Support
License: MIT