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

   또는 lgl-api-key라는 macOS 키체인 항목을 추가하거나, 일회성 실행을 위해 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 또는 키체인에 있으면 추가 환경 변수가 필요하지 않습니다. 일회성 재정의를 위해서만 호스트의 env 블록에 LGL_API_KEY를 설정하세요.

도구

모든 도구는 verbose: true를 허용하여 요약된 버전 대신 전체 LGL 객체를 가져옵니다. 간결한 기부자는 이름, 이메일, 전화번호, 도시/주를 포함합니다. 기부 날짜와 평생 총액은 get_constituent에만 있습니다. 간결한 기부는 날짜, 금액, fund_id, 메모, 기부자 이름(확장 시)을 포함합니다. 제한된 목록 응답에는 생략된 결과 수를 알려주는 note 필드가 포함됩니다 — 아무것도 조용히 잘리지 않습니다.

확인된 쿼리 구문

LGL의 /constituents/search와 /gifts/search는 자유 텍스트가 아닌 q[]=field=value 쌍을 사용합니다 — 이는 여러 필드에 대해 문서화되지 않았으며 실제 계정을 탐색하여 확인되었습니다:

• 기부자: name=<text> (LGL 자체 문서화 예제) 또는 정확한 이메일 일치를 위한 eaddr=<email> (문서화되지 않음; email=/email_address= 같은 추측은 거부됨).

• 기부: date_from=YYYY-MM-DD / date_to=YYYY-MM-DD (실제 필터로 확인됨 — 범위를 벗어난 날짜는 total_items를 0으로 만듦). 여러 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 오류 시 백오프로 재시도하므로, 많은 호출로 분산되는 광범위한 질문은 오류 대신 우아하게 성능이 저하됩니다.