little-green-light-mcp

Little Green Light ドナーCRM向けの読み取り専用 MCP サーバーです。 任意の stdio MCP クライアントから、構成員の検索、日付範囲でのギフト一覧表示、または 一人の寄付履歴の取得に使用できます。

サーバー名は lgl-mcp です。登録方法はホストによって異なります — セットアップを参照してください。

設計による読み取り専用

このサーバーには 作成、更新、削除ツールはありません — 無効化されているのではなく、存在しません。lgl.js は GET リクエスト関数のみを公開しており、このプロジェクト内でドナーレコードを変更できるコードパスは どこにもありません。変更後は npm run audit:readonly を実行して機械的に確認してください。

将来の書き込みパス（例：寄付の同期）は、ここではなく LGL 自身のレビュー済み統合キューに属します。

Related MCP server: SQL Server MCP

セットアップ

1. LGL から API キーを取得します：設定 → 統合設定 → LGL API。

2. それを ~/.config/lgl-mcp/env に保存します（既に作成済み、chmod 600）：

   LGL_API_KEY=your-key-here

   または、macOS キーチェーンに lgl-api-key という名前のアイテムを追加するか、LGL_API_KEY 環境変数を設定して1回限りの実行を行うこともできます。キーはログ出力、コミット、エラーメッセージでの表示は 一切行われません。

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 または キーチェーンにある場合、追加の環境変数は不要です。1回限りの上書きの場合のみ、 ホストの env ブロックで LGL_API_KEY を設定してください。

ツール

すべてのツールは verbose: true を受け付け、要約版ではなく完全な LGL オブジェクトを返します。 コンパクトな構成員には名前、メール、電話番号、市区町村/都道府県が含まれます。寄付日と生涯 総額は get_constituent のみに含まれます。コンパクトなギフトには日付、金額、fund_id、メモ、 およびドナー名（展開時）が含まれます。上限に達したリスト応答には、省略された結果の数を示す note フィールドが含まれます — 何も黙って切り詰められることはありません。

確認済みのクエリ構文

LGL の /constituents/search と /gifts/search は自由文ではなく q[]=field=value のペアを取ります — これはいくつかのフィールドで文書化されておらず、実際のアカウントへのプロービングで確認されました：

• 構成員：name=<テキスト>（LGL 自身の文書化された例）または eaddr=<メール> で完全一致の メール検索（文書化されていません；email=/email_address= のような推測は拒否されました）。

• ギフト：date_from=YYYY-MM-DD / date_to=YYYY-MM-DD（確認済みの実際のフィルター — 範囲外の日付は total_items をゼロにします）。複数の q[] エントリは AND 結合されます。

• ギフトにはこのエンドポイントに ファンドや金額のフィルターはありません — 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件のギフト）が 依然として適用されます；ヒットした場合は応答にその旨が記載されます。

開発

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

レート制限

LGL は5分間のウィンドウあたり300回のAPI呼び出しを許可しています。lgl.js は内部でスロットル（スライディングウィンドウ）し、 429/5xx でバックオフ付きでリトライするため、多くの呼び出しに分散する広範なクエリは エラーではなく段階的に劣化します。