Xentral MCP HTTP Server

A Model Context Protocol (MCP) HTTP server for Xentral ERP integration, providing powerful tools for daily ERP workflows.

🚀 Features

• Real MCP HTTP Server: Full JSON-RPC 2.0 compatible MCP implementation

• Auto-Discovery: Tools automatically discovered from xentral/ directory

• 100+ Tools: Comprehensive tool library for all ERP workflows (framework ready)

• Runtime Configuration: Update API credentials dynamically without restart

• Comprehensive Logging: All MCP requests, responses, and tool calls logged

• Health Monitoring: Built-in health checks and server information endpoints

• CORS Support: Compatible with web-based MCP clients

• Production Ready: Structured codebase with proper error handling

📋 Requirements

• Python 3.8 or higher

• Xentral ERP system with API access

• Valid Xentral API credentials

🛠️ Installation

1. Clone or Download

git clone https://github.com/yourusername/xentral-mcp.git
cd xentral-mcp

2. Install Dependencies

pip install -r requirements.txt

3. Configure Environment

Create .env file with your Xentral credentials:

cp .env.example .env
# Edit .env with your Xentral API URL and key

🏃 Running the Server

python mcp_server.py

🔍 Testing

# List all tools
python mcp_client.py list-tools

# Call a tool
python mcp_client.py call search_customers --name "Miller"

📁 Project Structure

• mcp_server.py - Main Flask HTTP server

• config.py - Configuration management

• mcp_protocol.py - MCP JSON-RPC protocol

• mcp_tools_parser.py - Tool documentation parser

• mcp_client.py - CLI testing client

• xentral/ - Tool implementations directory

• mcp-tools-list.md - Tool documentation

• .env.example - Configuration template

📞 Support

For issues, check the troubleshooting section in the full README or review logs in mcp_server.log.

Happy ERP automation! 🚀