little-green-light-mcp

Сервер MCP только для чтения для CRM доноров Little Green Light. Любой stdio MCP клиент может использовать его для поиска участников, списка пожертвований за период или получения истории пожертвований одного человека.

Имя сервера — lgl-mcp. Способ регистрации зависит от хоста — см. раздел Setup.

Read-only by construction

Этот сервер не имеет инструментов создания, обновления или удаления — не отключенных, а отсутствующих. lgl.js предоставляет только функцию GET-запроса; в этом проекте нет ни одного пути кода, который мог бы изменить запись донора. Выполните npm run audit:readonly после любых изменений, чтобы механически подтвердить это.

Любой будущий путь записи (например, синхронизация пожертвований) относится к собственной проверенной очереди интеграции LGL, а не сюда.

Related MCP server: SQL Server MCP

Setup

1. Получите API-ключ от LGL: Settings → Integration Settings → LGL API.

2. Поместите его в ~/.config/lgl-mcp/env (уже создан, chmod 600):

   LGL_API_KEY=your-key-here

   В качестве альтернативы добавьте элемент в связку ключей macOS с именем lgl-api-key или установите переменную окружения LGL_API_KEY для однократного запуска. Ключ никогда не логируется, не фиксируется и не отображается в сообщениях об ошибках.

3. Установите зависимости (уже выполнено при первом клонировании):

   npm install

4. Укажите stdio MCP хосту на этот сервер. Команда — node; аргумент — абсолютный путь к index.js:

   {
     "command": "node",
     "args": ["/absolute/path/to/little-green-light-mcp/index.js"]
   }

   Оберните это в конфигурацию, используемую вашим хостом (mcpServers, карта серверов верхнего уровня и т.д.). Дополнительные переменные окружения не требуются, если ключ находится в ~/.config/lgl-mcp/env или в связке ключей. Устанавливайте LGL_API_KEY в блоке env хоста только для однократного переопределения.

Tools

Каждый инструмент принимает verbose: true, чтобы получить полный объект LGL вместо сокращенной сводки. Компактные участники включают имя, email, телефон и город/штат. Даты пожертвований и общая сумма за все время доступны только в get_constituent. Компактные пожертвования включают дату, сумму, fund_id, примечание и имя донора (при развертывании). Ответы списков, которые ограничены, содержат поле note, указывающее, сколько результатов было пропущено — ничего не усекается молча.

Confirmed query syntax

Эндпоинты LGL /constituents/search и /gifts/search принимают пары q[]=field=value, а не произвольный текст — это было недокументировано для нескольких полей и подтверждено тестированием на живом аккаунте:

• Участники: name=<текст> (собственный документированный пример LGL) или eaddr=<email> для точного совпадения email (недокументировано; предположения вроде email=/email_address= были отклонены).

• Пожертвования: date_from=ГГГГ-ММ-ДД / date_to=ГГГГ-ММ-ДД (подтвержденные реальные фильтры — дата вне диапазона обнуляет total_items). Несколько записей q[] объединяются по И.

• Пожертвования не имеют фильтра по фонду или сумме на этом эндпоинте — fund_id, fund, fund_ids, campaign_id, amount_from, amount_to были опробованы и отклонены как неизвестные параметры. search_gifts не предоставляет их; при необходимости фильтруйте результаты на стороне клиента по fund_id / note.

• Имя донора пожертвования появляется только тогда, когда запрос включает expand=first_name,last_name,org_name — в противном случае LGL не вкладывает объект участника в ответ о пожертвовании.

• Суммы пожертвований get_constituent (дата первого/последнего пожертвования, общая сумма за все время) вообще не возвращаются LGL в объекте участника — они вычисляются здесь из истории пожертвований этого участника, с постраничной загрузкой до завершения. Участник без пожертвований возвращает lifetime_amount: 0. По-прежнему применяется ограничение безопасности (10 000 пожертвований); в ответе будет указано, если оно достигнуто.

Development

npm run inspect          # MCP Inspector — exercise tools interactively
npm run audit:readonly   # mechanical check: no POST/PATCH/PUT/DELETE anywhere

Rate limits

LGL разрешает 300 вызовов API за 5-минутное окно. lgl.js выполняет внутреннее ограничение (скользящее окно) и повторяет попытки с задержкой при ошибках 429/5xx, поэтому широкий запрос, который разветвляется на множество вызовов, деградирует плавно, а не вызывает ошибку.