sentrul-mcp-server

MCP 지원 클라이언트에서 Sentrul 리서치, 규정 준수 및 추적 조회 에이전트를 실행하세요. 하나의 게이트웨이 뒤에서 257개의 프로덕션 에이전트가 작동합니다.

버전: 0.1.0 | SDK: @modelcontextprotocol/sdk@1.29.0 | 라이선스: MIT

설치 (Claude Desktop)

~/Library/Application Support/Claude/claude_desktop_config.json에 다음 스니펫을 추가하세요:

{
  "mcpServers": {
    "sentrul": {
      "command": "npx",
      "args": ["-y", "sentrul-mcp-server"],
      "env": { "SENTRUL_API_KEY": "optional — free tier auto-provisions" }
    }
  }
}

Claude Desktop을 재시작하세요. 서버는 처음 사용할 때 무료 티어 키를 자동으로 프로비저닝하므로 별도의 가입이 필요하지 않습니다.

Related MCP server: Forage-mcp

도구

sentrul_research

URL을 가져와 콘텐츠에 대해 Sentrul의 리서치 에이전트를 실행합니다. 요약, 엔티티, 주장 및 공개 Langfuse 추적 URL을 반환합니다.

예시 프롬프트

• "https://example.com/report 를 조사하고 주요 주장을 요약해 줘"

• "https://arxiv.org/abs/2401.00001 에 대해 심층 리서치를 수행해 줘"

sentrul_compliance_scan

일반적인 규정 준수 패턴(PII, PCI, HIPAA, GDPR 데이터)에 대해 텍스트를 스캔합니다. 결과와 심각도를 반환합니다. 법적 조언이 아닙니다.

예시 프롬프트

• "이 문서에서 PII 및 PCI 위반 사항을 스캔해 줘: [텍스트 붙여넣기]"

• "다음 개인정보 처리방침에서 GDPR 데이터 패턴을 확인해 줘"

sentrul_trace_lookup

ID를 통해 공개 Langfuse 추적을 검색합니다. 검사를 위해 구조화된 추적 페이로드를 반환합니다.

예시 프롬프트

• "Sentrul에서 추적 clm8abc123xyz를 가져와 줘"

• "추적 ID abc-def-456에 대한 관찰 트리(observation tree)를 보여 줘"

환경 변수

익명 무료 티어

SENTRUL_API_KEY가 설정되지 않은 경우, 서버는 다음을 수행합니다:

1. ~/.sentrul/mcp-key에서 캐시된 키를 확인합니다.

2. 캐시가 없으면 POST /v1/mcp/keys/anonymous를 호출하여 속도 제한이 있는 무료 키를 자동으로 프로비저닝합니다.

3. 향후 실행을 위해 키를 ~/.sentrul/mcp-key(모드 0600)에 저장합니다.

MCP 클라이언트 설정에서 SENTRUL_API_KEY를 설정하여 언제든지 업그레이드할 수 있습니다.

보안 참고 사항

• 셸 실행 없음 — 서버는 셸 명령을 실행하거나 하위 프로세스를 생성하지 않습니다.

• PII 로깅 없음 — 환경 변수와 API 키는 로그나 표준 출력(stdout)에 기록되지 않습니다.

• 읽기 전용 — 세 가지 도구 모두 실행 시 읽기 전용이며, 사용자 파일이나 외부 상태에 쓰기를 수행하지 않습니다.

• 파일 시스템 쓰기 — 유일한 쓰기 작업은 ~/.sentrul/mcp-key(키 캐시)에만 수행됩니다. 해당 디렉터리 외부에는 아무것도 기록되지 않습니다.

• 공급망 — 배포 시 2FA가 적용된 npm 계정 + sigstore 인증을 사용합니다(사용 가능한 경우 SECURITY.md 참조).

개발

pnpm install
pnpm run build   # tsc → dist/
pnpm test        # vitest run

# Smoke test — should print 3 tools in the tools/list response:
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/index.js

링크

• 홈페이지: https://sentrul.com

• 저장소: https://github.com/sentrul/sentrul-mcp-server

• 이슈: https://github.com/sentrul/sentrul-mcp-server/issues

MIT 라이선스 — Copyright (c) 2026 Sentrul