MOCO MCP Server

Вместо ручного определения конечных точек этот сервер использует официальную спецификацию MOCO OpenAPI (включённую в каталог openapi/) и полный парсер схемы ссылок для автоматической генерации всех доступных инструментов MCP. Это даёт любой MCP-совместимой LLM (например, Claude) мгновенный доступ ко всем операциям чтения и записи (GET, POST, PUT, DELETE) API MOCO v1, с точными описаниями инструментов и схемами параметров.

Разработано и поддерживается Levisteria GbR (Эдди Лакманн).

Возможности

• Полное покрытие API: Автоматически генерирует инструменты для учёта рабочего времени, проектов, счетов, контактов и всех остальных конечных точек MOCO.

• Режим безопасности: Может быть ограничен режимом READ_ONLY через переменные окружения, чтобы предотвратить случайное изменение данных LLM.

• Всегда актуально: Загружает последнюю спецификацию API от MOCO при каждом запуске сервера.

• Простота запуска: Запускается напрямую через npx.

Related MCP server: Odoo MCP Server

Предварительные требования

• Node.js (v24 или выше)

• Учётная запись MOCO (<your-account>.mocoapp.com)

• Ключ API MOCO (находится в MOCO в разделе Профиль > Интеграции)

Быстрый старт (npx)

Вы можете запустить сервер напрямую, не устанавливая его глобально:

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

Настройка в Claude Desktop / Cursor

Добавьте сервер в вашу конфигурацию MCP (например, в Claude Desktop или Cursor).

Использование npx (рекомендуется для локального использования)

{
  "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. Установите зависимости:

npm install

3. Соберите проект:

npm run build

4. Запустите локально:

npm start

Как это работает

1. Сервер загружает встроенную спецификацию MOCO OpenAPI из каталога openapi/.

2. Он использует @apidevtools/swagger-parser для разрешения всех ссылок $ref, обеспечивая полные и точные JSON-схемы.

3. Он анализирует все пути (например, /activities) и методы (например, GET, POST) и извлекает их сводки и описания.

4. Он преобразует параметры и тела запросов в JSON-схемы, понятные MCP.

5. Сгенерированные инструменты называются, например, get_activities или post_activities.

6. Когда LLM вызывает инструмент, сервер пересылает аутентифицированный запрос в MOCO и возвращает результат в формате JSON.

Лицензия

Лицензия MIT