@nicola5tor/openproject-timelog

MCP-сервер (Model Context Protocol) для ведения локального журнала часов и синхронизации с OpenProject (API v3). Записывайте свою работу на естественном языке из Claude Desktop (или другого MCP-клиента), просматривайте её и загружайте в OpenProject, когда будет готово.

• Транспорт: stdio

• Локальное хранилище: ~/.openproject-timelog/entries.json

• Конфигурация: переменные окружения OPENPROJECT_URL и OPENPROJECT_API_KEY

Установка

Ничего глобально устанавливать не нужно: сервер запускается через npx.

# probarlo directamente
npx @nicola5tor/openproject-timelog

Или установить в проект:

npm install @nicola5tor/openproject-timelog
# o
pnpm add @nicola5tor/openproject-timelog

Related MCP server: OpenProject MCP Server

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

Отредактируйте файл конфигурации (claude_desktop_config.json) и добавьте сервер в раздел mcpServers:

{
  "mcpServers": {
    "openproject-timelog": {
      "command": "npx",
      "args": ["-y", "@nicola5tor/openproject-timelog"],
      "env": {
        "OPENPROJECT_URL": "https://tu-openproject.example.com",
        "OPENPROJECT_API_KEY": "TU_API_KEY"
      }
    }
  }
}

Перезапустите Claude Desktop после сохранения.

Как получить API-ключ OpenProject

В OpenProject: Моя учётная запись → Access tokens → API и сгенерируйте ключ. Сервер аутентифицируется с помощью Basic auth, используя литеральное имя пользователя apikey и ваш ключ в качестве пароля.

Инструменты только локальные (log_entry, list_entries, edit_entry, assign_entry, delete_entry, clear_sent) работают даже без настройки OpenProject. Инструменты запроса и загрузки требуют OPENPROJECT_URL и OPENPROJECT_API_KEY.

Инструменты

Локальный журнал

Запрос OpenProject

Синхронизация

* = обязательно.

Примечания по поведению

• Локальные идентификаторы — UUID v4. Часы хранятся в десятичном виде (1.5 = 1ч30м) и преобразуются в длительность ISO 8601 (PT1H30M) при загрузке.

• projectId записи, если не указан, выводится из рабочего пакета при загрузке (дополнительный вызов к OpenProject).

• JSON-файл записывается атомарно (временный файл + переименование), а операции сериализуются для предотвращения повреждения.

• Ошибки сети / учётных данных / прав возвращаются как читаемые сообщения в ответе инструмента, не обрушивая сервер.

Примеры разговорного использования

Вы: Запиши 2 часа сегодня на исправление логина, задача 1234. Claude: (вызывает log_entry с description="исправить логин", hours=2, workPackageId=1234)

Вы: Запиши мне 45 минут совещания, задачу потом поставлю. Claude: (log_entry description="совещание", hours=0.75) — остаётся не назначенной.

Вы: Что у меня не отправлено? Claude: (list_entries status="pending")

Вы: Этим двум совещаниям поставь задачу 1234. Claude: (assign_entry entryIds=[...], workPackageId=1234)

Вы: Какие есть виды деятельности? Поставь "Development" всем и загрузи. Claude: (get_activities → edit_entry/assign для activityId → upload_entries)

Вы: Очисти то, что уже загружено. Claude: (clear_sent)

Разработка

npm install      # instala deps y compila (prepare -> build)
npm run build    # compila TypeScript a dist/
npm start        # ejecuta dist/index.js

Структура:

openproject-timelog/
├── src/
│   ├── index.ts        # entry point, setup MCP y registro de tools
│   ├── store.ts        # CRUD bitácora local (JSON atómico)
│   ├── openproject.ts  # cliente API OpenProject v3
│   └── types.ts        # interfaces/types
├── package.json
├── tsconfig.json
└── README.md

Лицензия

MIT