mcp-data-gateway

AI 클라이언트를 한 사람에게 건네면 MCP는 쉽습니다. 팀에 건네면 — 분석가, 인사 운영 담당자, 리더, 각자 다른 시스템에 대한 권한이 있는 — 서버는 방어할 수 있는 답이 필요합니다: 누가 호출하는지, 무엇을 만질 수 있는지? 이 저장소는 그 답을 핵심 부품만으로 잘라낸 것입니다.

하나의 allows() 결정이 모든 것을 좌우합니다. 각 신원이 보는 것을 필터링하고, 시도하는 것을 거부하므로, 도구 목록이 호출자와 시스템 사이를 막는 유일한 장벽이 되지 않습니다. 권한은 폐쇄적으로 실패합니다: 저장소가 없거나 손상되면 모든 사람을 거부하며, 코드에 존재하는 비상용 슈퍼유저만 예외입니다. 이는 저장소 장애가 저장소를 고치는 사람을 잠글 수 없도록 하기 위함입니다. 모든 호출 — 그리고 모든 거부 — 크기 상한 감사 기록으로 남습니다.

내장된 설계 결정:

• 권한은 도구를 하나씩 지정합니다. 글로브(glob)는 로드 시 거부됩니다. 다음 분기에 누군가 배포하는 쓰기 도구가 읽기 전용 신원에 상속되는 방식으로 들어가지 않도록 하기 위해서입니다.

• 두 시스템을 연결하는 도구는 둘을 선언하며, 호출자는 둘 다 필요합니다. 누출되는 것은 이름이 아니라 읽기입니다.

• 스냅샷 테스트는 도구 표면을 고정하고, 두 번째 테스트는 쓰기 표면을 정확히 하나의 도구로 유지합니다.

• SQL 게이트는 빠르고 구체적인 거부를 제공합니다. 그러나 실제 경계는 데이터베이스 신원의 권한입니다. 텍스트 스캔은 우회할 수 있습니다. IAM은 우회할 수 없습니다.

빠른 시작

python3 -m unittest discover -s tests   # no dependencies
python3 -m gateway.demo                 # three identities, one denial on the record
pip install mcp && GATEWAY_IDENTITY=analyst@example.com python3 -m gateway.server

Related MCP server: mcp-policy-gateway

더 깊이 알아보기

docs/design.md는 캡처된 출력과 함께 구성 요소를 설명합니다. docs/rules.md는 모든 규칙에 이유와 테스트를 제공합니다. docs/lineage.md는 정직한 한계와 출처를 담고 있습니다.

2026년 8월, 각 규칙을 어렵게 얻은 프로덕션 게이트웨이에서 증류되었습니다. 커밋 로그는 증류 시점부터 시작됩니다.