TrytonMCP Agent Specification

Overview

TrytonMCP is an MCP (Model Context Protocol) server that enables LLMs to interact with Tryton ERP functionality through RPC calls. It wraps the sabatron-tryton_rpc_client library and exposes Tryton models as callable tools.

Project Structure

TrytonMCP/
├── src/
│   └── tryton_mcp/
│       ├── __init__.py
│       ├── config.py          # Settings singleton with TrytonSettings
│       └── server.py          # Main MCP server with tool definitions
├── test_rpc.py                 # Standalone RPC test script
├── pyproject.toml             # Project dependencies
└── .env.example               # Environment variables template

Architecture

Dependencies

fastmcp[tasks]>=3.1.0 - MCP server framework
sabatron-tryton-rpc-client>=7.4.0 - Tryton RPC client

Core Components

Settings (config.py) - Singleton pattern for configuration management
- Uses environment variables with defaults
- Provides to_dict() and get_client() methods
- Validates required fields in __post_init__
Tools (server.py) - Functions decorated with @mcp.tool():
- create_schedule - Creates appointments in Naliia module
- find_service_centers - Searches service centers
- find_products_and_services - Searches salable products

Adding New Tools

To add a new Tryton model as an MCP tool:

@mcp.tool()
def your_tool_name(param1: int, param2: str) -> List[dict]:
    client = settings.get_client()
    client.connect()
    
    name = "model.your.model.method"
    args = [params, ...]
    response = client.call(name, args)
    
    return response

Running the Server

# Activate virtual environment
source .venv/bin/activate

# Run MCP server (stdio mode)
python -m tryton_mcp.server

# Or use fastmcp CLI
fastmcp run tryton_mcp.server

Configuration

Credentials are loaded from environment variables (with sensible defaults):

export TRYTON_HOSTNAME=dev.naliia.co
export TRYTON_DATABASE=capacitacion
export TRYTON_USERNAME=admin
export TRYTON_PASSWORD=admin
export TRYTON_PORT=8000

Or copy .env.example to .env and adjust values:

cp .env.example .env

Note: .env is gitignored to protect credentials.

Testing RPC Calls

Use test_rpc.py to test Tryton RPC calls independently:

python test_rpc.py

2.4 KiB Raw Blame History