MCP с N8N

mcp-autopeças с n8n

MCP-сервер на Python, который читает и записывает данные на вкладки Google Sheets через протокол MCP — совместим с Claude Desktop, Claude Code и любым MCP-клиентом (включая узел mcpClientTool в N8N).

Сервер охватывает два домена в рамках одного процесса, каждый из которых привязан к вкладке одной и той же таблицы:

Домен	Вкладка	Инструменты
Автозапчасти (AutoMax)	`AutoPeças` (gid=0)	6 инструментов — только чтение
Больничные койки	`Leitos` (gid=1562350974)	9 инструментов — чтение, запись, e-mail и SMS

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

Python 3.12+
uv (рекомендуется) или pip
Сервисный аккаунт Google с правами Редактора таблицы (необходимо для leitos_atualizar_status_limpeza)

Установка

cd mcp-alura
uv sync          # ou: pip install -e .

Настройка

1. Учетные данные Google (Service Account)

В Google Cloud Console:

Создайте проект → APIs & Services → Включите Google Sheets API
Создайте Service Account → сгенерируйте и скачайте JSON-ключ
Поделитесь таблицей с адресом электронной почты сервисного аккаунта с правами Редактора

2. Переменные окружения

cp .env.example .env

Отредактируйте файл .env, указав как минимум:

SPREADSHEET_ID=1zt4h2v3ldK3zELNNmvyn02elEB9dHdfXD5q85ZYh2k0
AUTOPECAS_SHEET_NAME=AutoPeças
LEITOS_SHEET_NAME=Leitos
GOOGLE_CREDENTIALS_PATH=/caminho/para/service_account.json

# Para leitos_enviar_notificacao (e-mail):
GMAIL_USER=setor@hospital.com.br
GMAIL_APP_PASSWORD=xxxx_xxxx_xxxx_xxxx

# Para leitos_enviar_sms:
TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TWILIO_AUTH_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TWILIO_FROM_NUMBER=+18647139932

SPREADSHEET_ID находится в URL: docs.google.com/spreadsheets/d/**{ID}**/edit

Ожидаемая структура таблицы

Вкладка AutoPeças:

Código	Nome	Categoria	Marca	Preço	Estoque	Fornecedor	Descrição	Localização
F-1023	Filtro de Óleo	Motor	Bosch	35.90	48	AutoDist	...	Prateleira A3

Вкладка Leitos — столбцы, подтвержденные схемой узла N8N:

ID_Leito	Quarto	Tipo_Quarto	Status_Ocupacao	Status_Limpeza	Paciente	Ultima_Limpeza
A-101	Quarto 10	Enfermaria	Ocupado	Concluído	João Silva	2025-03-28
UTI-05	UTI Norte	UTI	Disponível	Pendente	—	2025-03-27

Имена столбцов можно настроить в .env с помощью COL_* и LEITOS_COL_*.

Инструменты AutoPeças

Инструмент	Что делает
`autopecas_buscar_peca`	Поиск по имени, коду или описанию
`autopecas_listar_pecas`	Список каталога с пагинацией и фильтрами
`autopecas_obter_detalhes`	Полные детали детали по коду
`autopecas_listar_categorias`	Категории с количеством деталей
`autopecas_verificar_estoque`	Запасы по коду или сводка по категории
`autopecas_listar_marcas`	Производители с количеством деталей

Инструменты Больничные койки

Сопоставление агентов N8N (mcp-all-nodes.json) с инструментами Python:

Агент N8N	Фильтр	Эквивалентные инструменты
Агент Дирекции	Полный доступ	`leitos_listar_leitos`, `leitos_resumo_ocupacao`, `leitos_verificar_disponibilidade`, `leitos_obter_detalhes_leito`
Агент Медсестринства	`Tipo_Quarto = Enfermaria`	`leitos_listar_enfermaria`
Агент ОРИТ	`Tipo_Quarto = UTI`	`leitos_listar_uti`
Все агенты	—	`leitos_enviar_notificacao`, `leitos_enviar_sms`
Узел записи N8N	`row_number` → `ID_Leito`	`leitos_atualizar_status_limpeza`

Инструмент	Чтение/Запись	Что делает
`leitos_listar_leitos`	Чтение	Список всех коек; фильтрация по `Tipo_Quarto`, `Status_Ocupacao`, `Status_Limpeza`
`leitos_listar_enfermaria`	Чтение	Фиксированный фильтр `Tipo_Quarto=Enfermaria` — отчеты о занятости и уборке
`leitos_listar_uti`	Чтение	Фиксированный фильтр `Tipo_Quarto=UTI` — дни госпитализации и количество пациентов
`leitos_verificar_disponibilidade`	Чтение	Койки со `Status_Ocupacao=Disponível`, сводка по типу
`leitos_obter_detalhes_leito`	Чтение	Полные данные койки по `ID_Leito`
`leitos_resumo_ocupacao`	Чтение	Дашборд: занятость и уборка, сгруппированные по `Tipo_Quarto`
`leitos_atualizar_status_limpeza`	Запись	Обновляет `Status_Limpeza` койки по `ID_Leito`
`leitos_enviar_notificacao`	Внешний	Отправляет e-mail через Gmail SMTP
`leitos_enviar_sms`	Внешний	Отправляет SMS через Twilio REST API

Status_Ocupacao: Disponível 🟢 · Ocupado 🔴 · Reservado 🔵

Status_Limpeza: Concluído ✅ · Pendente ⚠️ · Em Andamento 🔄

Типы комнат: Enfermaria · UTI · Apartamento · Semi-Intensivo

Настройка отправки e-mail

Инструмент leitos_enviar_notificacao использует Gmail SMTP с паролем приложения:

Включите двухэтапную аутентификацию в аккаунте Google
Перейдите на myaccount.google.com/apppasswords
Создайте пароль для "Email" и вставьте его в GMAIL_APP_PASSWORD в файле .env

Настройка отправки SMS

Инструмент leitos_enviar_sms использует Twilio REST API:

Создайте аккаунт на twilio.com
Получите Account SID и Auth Token в дашборде
Зарегистрируйте или купите номер отправителя и настройте TWILIO_FROM_NUMBER

Использование в Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "hospital-mcp": {
      "command": "uv",
      "args": ["run", "--project", "/caminho/para/mcp-alura", "python", "server.py"],
      "env": {
        "SPREADSHEET_ID": "1zt4h2v3ldK3zELNNmvyn02elEB9dHdfXD5q85ZYh2k0",
        "AUTOPECAS_SHEET_NAME": "AutoPeças",
        "LEITOS_SHEET_NAME": "Leitos",
        "GOOGLE_CREDENTIALS_PATH": "/caminho/para/service_account.json",
        "GMAIL_USER": "setor@hospital.com.br",
        "GMAIL_APP_PASSWORD": "xxxx_xxxx_xxxx_xxxx",
        "TWILIO_ACCOUNT_SID": "ACxxxxxxxx",
        "TWILIO_AUTH_TOKEN": "xxxxxxxx",
        "TWILIO_FROM_NUMBER": "+18647139932"
      }
    }
  }
}

Использование в Claude Code

claude mcp add hospital-mcp -- uv run --project /caminho/para/mcp-alura python server.py

Использование в N8N (MCP Client)

Настройте узел MCP Client Tool, указав эндпоинт сервера. Три агента N8N могут использовать один и тот же MCP-сервер Python, каждый из них использует инструменты, соответствующие его роли, через include: selected.

Локальное тестирование

uv run python server.py

Для проверки 15 инструментов с помощью MCP Inspector:

npx @modelcontextprotocol/inspector uv run python server.py

AutoPeças MCP Server