N8NでのMCP利用

n8n対応 mcp-autopeças

MCPプロトコルを介してGoogle Sheetsのシートの読み書きを行うPython製MCPサーバーです。Claude Desktop、Claude Code、およびあらゆるMCPクライアント（N8Nの mcpClientTool ノードを含む）と互換性があります。

このサーバーは単一のプロセスで2つのドメインをカバーしており、それぞれが同じスプレッドシートの異なるシートにマッピングされています。

ドメイン	シート	ツール
自動車部品 (AutoMax)	`AutoPeças` (gid=0)	6ツール — 読み取り専用
病床管理	`Leitos` (gid=1562350974)	9ツール — 読み取り、書き込み、メール、SMS

前提条件

Python 3.12+
uv (推奨) または pip
スプレッドシートに対する 編集者 権限を持つGoogleサービスアカウント (leitos_atualizar_status_limpeza に必要)

インストール

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

設定

1. Google認証情報 (サービスアカウント)

Google Cloud Console にて:

プロジェクトを作成 → APIとサービス → Google Sheets API を有効化
サービスアカウント を作成 → 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	オイルフィルター	エンジン	Bosch	35.90	48	AutoDist	...	棚 A3

Leitos シート — N8Nノードのスキーマで確認された列:

ID_Leito	Quarto	Tipo_Quarto	Status_Ocupacao	Status_Limpeza	Paciente	Ultima_Limpeza
A-101	10号室	病棟	使用中	完了	João Silva	2025-03-28
UTI-05	北ICU	ICU	空き	保留	—	2025-03-27

列名は .env 内の COL_* および LEITOS_COL_* で調整可能です。

自動車部品ツール

ツール	機能
`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`
ICUエージェント	`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`	書き込み	`ID_Leito` から病床の `Status_Limpeza` を更新
`leitos_enviar_notificacao`	外部	Gmail SMTP経由でメール送信
`leitos_enviar_sms`	外部	Twilio REST API経由でSMS送信

Status_Ocupacao: Disponível (空き) 🟢 · Ocupado (使用中) 🔴 · Reservado (予約済み) 🔵

Status_Limpeza: Concluído (完了) ✅ · Pendente (保留) ⚠️ · Em Andamento (進行中) 🔄

部屋タイプ: Enfermaria (病棟) · UTI (ICU) · Apartamento (個室) · Semi-Intensivo (準集中治療室)

メール送信の設定

leitos_enviar_notificacao ツールはアプリパスワードを使用したGmail SMTPを利用します:

Googleアカウントで2段階認証を有効化
myaccount.google.com/apppasswords にアクセス
「メール」用のパスワードを作成し、.env の GMAIL_APP_PASSWORD に貼り付け

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クライアント)

サーバーのエンドポイントを指すように MCP Client Tool ノードを設定します。 3つのN8Nエージェントは同じPython MCPサーバーを共有でき、それぞれが include: selected を通じて自身の役割に適したツールを使用できます。

ローカルテスト

uv run python server.py

MCP Inspectorで15個のツールを検査する場合:

npx @modelcontextprotocol/inspector uv run python server.py

AutoPeças MCP Server