MOCO MCP Server

Anstatt Endpunkte manuell zu definieren, verwendet dieser Server die offizielle MOCO OpenAPI-Spezifikation (gebündelt im openapi/-Verzeichnis) und einen vollständigen Schema-Referenz-Parser, um automatisch alle verfügbaren MCP-Tools zu generieren. Dies gibt jeder MCP-kompatiblen LLM (wie Claude) sofortigen Zugriff auf alle Lese- und Schreiboperationen (GET, POST, PUT, DELETE) der MOCO API v1, komplett mit präzisen Tool-Beschreibungen und Parameterschemata.

Entwickelt und gepflegt von Levisteria GbR (Eddy Lackmann).

Funktionen

• Vollständige API-Abdeckung: Generiert automatisch Tools für Zeiterfassung, Projekte, Rechnungen, Kontakte und alle anderen MOCO-Endpunkte.

• Sicherheitsmodus: Kann über Umgebungsvariablen auf READ_ONLY beschränkt werden, um versehentliche Datenänderungen durch die LLM zu verhindern.

• Immer aktuell: Ruft bei jedem Serverstart die neueste API-Spezifikation von MOCO ab.

• Einfache Ausführung: Direkt über npx ausführen.

Related MCP server: Odoo MCP Server

Voraussetzungen

• Node.js (v24 oder höher)

• Ein MOCO-Konto (<your-account>.mocoapp.com)

• Ein MOCO-API-Schlüssel (in MOCO unter Profil > Integrationen zu finden)

Schnellstart (npx)

Sie können den Server direkt ausführen, ohne ihn global zu installieren:

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

Konfiguration in Claude Desktop / Cursor

Fügen Sie den Server zu Ihrer MCP-Konfiguration hinzu (z. B. in Claude Desktop oder Cursor).

Verwendung von npx (empfohlen für lokale Nutzung)

{
  "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

2. Abhängigkeiten installieren:

npm install

3. Projekt bauen:

npm run build

4. Lokal ausführen:

npm start

So funktioniert es

1. Der Server lädt die gebündelte MOCO OpenAPI-Spezifikation aus dem openapi/-Verzeichnis.

2. Er verwendet @apidevtools/swagger-parser, um alle $ref-Verknüpfungen aufzulösen, um vollständige und genaue JSON-Schemata zu gewährleisten.

3. Er analysiert alle Pfade (z. B. /activities) und Methoden (z. B. GET, POST) und extrahiert deren Zusammenfassungen und Beschreibungen.

4. Er übersetzt die Parameter und Anfragekörper in JSON-Schemata, die MCP versteht.

5. Die generierten Tools werden z. B. get_activities oder post_activities genannt.

6. Wenn die LLM ein Tool aufruft, leitet der Server die authentifizierte Anfrage an MOCO weiter und gibt das JSON-Ergebnis zurück.

Lizenz

MIT-Lizenz