EspoCRM과 원활한 통합을 위한 포괄적인 모델 Context Protocol (MCP) 서버. 이 서버는 표준 인터페이스를 통해 EspoCRM 인스턴스와 상호 작용하는 AI 조수가 활성화되어 연락처, 계정, 기회, 회의, 사용자, 작업, 리드 및 고급 시스템 관리 기능을 제공합니다.

** NEW: AI Chatbot Integration** - 이제 모든 47 MCP 도구에 대한 자연적인 언어 액세스를 제공하는 EspoCRM에 직접 삽입하는 완전한 chatbot 인터페이스를 포함합니다!

특징

핵심 능력

-Complete CRUD Operations - 생성, 읽기, 업데이트 및 삭제

• Multi-Entity Support - 연락처, 계정, 기회, 회의, 사용자, 작업 및 리드
• Advanced Search & Filtering - 날짜 범위, 질 및 복잡한 필터와 유연한 검색
• Task Management - 부모의 관계와 사용자 할당을 통한 완전한 작업 수명주기
• Lead Management - 변환을 통한 전체 리드 파이프라인
• Meeting Management - 참석자 관리와 풀 캘린더 통합
• User Management - 포괄적인 사용자 검색 및 조회 기능

EspoCRM MCP Server

A comprehensive Model Context Protocol (MCP) server for seamless integration with EspoCRM. This server enables AI assistants to interact with your EspoCRM instance through a standardized interface, providing complete CRUD operations for Contacts, Accounts, Opportunities, Meetings, Users, Tasks, Leads, and advanced system management capabilities.

** NEW: AI Chatbot Integration** - Now includes a complete chatbot interface that embeds directly into your EspoCRM, providing natural language access to all 47 MCP tools!

Features

Core Capabilities

• Complete CRUD Operations - Create, read, update, and delete entities
• Multi-Entity Support - Contacts, Accounts, Opportunities, Meetings, Users, Tasks, and Leads
• Advanced Search & Filtering - Flexible search with date ranges, pagination, and complex filters
• Task Management - Complete task lifecycle with parent relationships and user assignment
• Lead Management - Full lead pipeline from creation to conversion
• Meeting Management - Full calendar integration with attendee management
• User Management - Comprehensive user search and lookup capabilities
• Real-time Validation - Zod-based schema validation for all operations
• Comprehensive Logging - Winston-powered logging with multiple levels

Authentication & Security

• Multiple Auth Methods - API Key and HMAC authentication support
• Secure Configuration - Environment-based configuration management
• Rate Limiting - Built-in rate limiting for API protection
• Error Handling - Robust error handling with detailed logging

Calendar Integration

• Meeting Operations - Create, search, update, and manage meetings
• Attendee Management - Link contacts and users to meetings
• Date/Time Filtering - Advanced date range search capabilities
• Google Calendar Sync Compatibility - Designed for calendar synchronization workflows

AI Chatbot Integration

• Floating Chat Widget - Beautiful, non-intrusive chat bubble interface
• Natural Language Processing - Chat in plain English to perform CRM operations
• Real-time Communication - WebSocket-powered instant responses
• 47 MCP Tools Access - Complete CRM functionality via chat
• EspoCRM Embedding - Integrates directly into your EspoCRM interface
• Mobile Responsive - Works seamlessly on all devices

Developer Experience

• TypeScript - Full TypeScript support with strict typing
• Docker Support - Containerized deployment ready
• Comprehensive Testing - Multiple test scripts and validation tools
• MCP 2024/2025 Compliant - Latest MCP specification support

Quick Start

Prerequisites

• Node.js 18+
• npm or yarn
• EspoCRM instance with API access
• Valid API credentials

Installation

1. Clone the repository

git clone https://github.com/zaphod-black/EspoMCP.git
cd EspoMCP

2. Install dependencies

npm install