MOCO MCP Server

En lugar de definir endpoints manualmente, este servidor utiliza la especificación oficial de MOCO OpenAPI (incluida en el directorio openapi/) y un analizador completo de referencias de esquemas para generar automáticamente todas las herramientas MCP disponibles. Esto brinda a cualquier LLM compatible con MCP (como Claude) acceso instantáneo a todas las operaciones de lectura y escritura (GET, POST, PUT, DELETE) de la API v1 de MOCO, con descripciones precisas de herramientas y esquemas de parámetros.

Desarrollado y mantenido por Levisteria GbR (Eddy Lackmann).

Características

• Cobertura completa de la API: Genera automáticamente herramientas para Time Tracking, Proyectos, Facturas, Contactos y todos los demás endpoints de MOCO.

• Modo de seguridad: Se puede restringir a READ_ONLY mediante variables de entorno para evitar modificaciones accidentales de datos por parte del LLM.

• Siempre actualizado: Obtiene la especificación más reciente de la API de MOCO en cada inicio del servidor.

• Ejecución sencilla: Se ejecuta directamente mediante npx.

Related MCP server: Odoo MCP Server

Requisitos previos

• Node.js (v24 o superior)

• Una cuenta de MOCO (<your-account>.mocoapp.com)

• Una clave de API de MOCO (se encuentra en MOCO en Perfil > Integraciones)

Inicio rápido (npx)

Puedes ejecutar el servidor directamente sin instalarlo de forma global:

export MOCO_DOMAIN="your-account-name"
export MOCO_API_KEY="your-api-key"
npx -y @levisteria-solutions/moco-mcp-server

Configuración en Claude Desktop / Cursor

Añade el servidor a tu configuración de MCP (por ejemplo, en Claude Desktop o Cursor).

Uso de npx (recomendado para uso local)

{
  "mcpServers": {
    "moco": {
      "command": "npx",
      "args": ["-y", "@levisteria-solutions/moco-mcp-server"],
      "env": {
        "MOCO_DOMAIN": "your-account-name",
        "MOCO_API_KEY": "your-api-key",
        "MOCO_READ_ONLY": "false"
      }
    }
  }
}

## Environment Variables

| Variable | Description | Example |
|----------|-------------|---------|
| `MOCO_DOMAIN` | Your MOCO subdomain (without `.mocoapp.com`) | `mycompany` |
| `MOCO_API_KEY` | Your personal or account API Key | `12345abcdef...` |
| `MOCO_READ_ONLY` | If `true`, only GET requests (reading) are allowed. POST/PUT/DELETE are blocked. | `true` or `false` |

## Development

1. Clone the repository:
```bash
git clone https://github.com/levisteria/moco-mcp-server.git
cd moco-mcp-server

1. Instala las dependencias:

npm install

2. Compila el proyecto:

npm run build

3. Ejecuta localmente:

npm start

Cómo funciona

1. El servidor carga la especificación de MOCO OpenAPI incluida desde el directorio openapi/.

2. Utiliza @apidevtools/swagger-parser para desreferenciar todos los enlaces $ref, garantizando esquemas JSON completos y precisos.

3. Analiza todas las rutas (por ejemplo, /activities) y métodos (por ejemplo, GET, POST) y extrae sus resúmenes y descripciones.

4. Traduce los parámetros y los cuerpos de solicitud en esquemas JSON que MCP entiende.

5. Las herramientas generadas se nombran, por ejemplo, get_activities o post_activities.

6. Cuando el LLM llama a una herramienta, el servidor reenvía la solicitud autenticada a MOCO y devuelve el resultado JSON.

Licencia

Licencia MIT