SME Library MCP

A free, open-source MCP server for creating, searching, and sharing SME(주제 전문가) 프로필 that AI agents can consult. 누구나 자신의 에이전트를 연결하고, 공유 라이브러리에서 검증된 전문가를 가져오고, 자신의 워크스페이스에 비공개 전문가를 유지하며, 검증된 승격 파이프라인을 통해 좋은 전문가를 기여할 수 있습니다 — 또는 전체 스택을 자체 호스팅할 수도 있습니다.

MIT License에 따라 라이선스가 부여됩니다. 이슈와 풀 리퀘스트를 통한 기여를 환영합니다.

Vercel(Next.js + Streamable HTTP 전송) 및 Supabase 백엔드에서 실행됩니다. 처음이신가요? **User Guide**를 읽어 보세요 — 작동 방식과 모든 SME 필드 및 값 범위에 대한 완전한 참조가 담겨 있습니다(앱 내 /guide에서도 제공). 전체 설계와 로드맵은 ARCHITECTURE.md, 단계별 배포 런북은 docs/SME_MCP_Implementation_Checklist.pdf를 참조하세요(docs/implementation-checklist.html에서 재생성 가능).

도구

Related MCP server: HiveMind

설정

1. Supabase

프로젝트를 만든 후 마이그레이션을 적용하세요:

supabase link --project-ref <ref>
supabase db push                    # applies supabase/migrations/*.sql
supabase functions deploy embed     # optional: enables semantic/hybrid search

embed 에지 함수는 내장된 gte-small 모델을 실행합니다. 없어도 됩니다. 이것이 없으면 검색이 자동으로 키워드 FTS(전체 텍스트 검색)로 대체됩니다.

2. API 키 가져오기

셀프 서비스(권장): /dashboard를 방문해 계정(Supabase Auth)을 만들고 키를 발급받으세요. 첫 로그인 시 워크스페이스가 자동으로 생성됩니다. 이는 SUPABASE_ANON_KEY가 설정되어 있고 Supabase 프로젝트에서 이메일 인증이 활성화되어 있어야 합니다.

운영자 / CLI: 관리자 키 또는 스크립트 프로비저닝의 경우:

SUPABASE_URL=... SUPABASE_SERVICE_ROLE_KEY=... \
  node scripts/create-key.mjs --workspace "My Team"            # read,write key
  node scripts/create-key.mjs --workspace "Ops" --admin        # admin key

어느 쪽이든 평문 키(sme_live_...)는 한 번만 표시되며, 저장되는 것은 SHA-256 해시뿐입니다.

3. Vercel에 배포

vercel deploy

Vercel 프로젝트에서 환경 변수를 설정하세요: SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY, SUPABASE_ANON_KEY(대시분드를 작동시키는 키), ANTHROPIC_API_KEY, CRON_SECRET(품질 점수 재계산, rate-limit 상한 정리, 임베딩 백필을 하는 일일 /api/cron/maintenance 작업을 보호). 또한 NEXT_PUBLIC_BASE_URL에 정식 사이트 URL을, ADMIN_EMAILS(쉼표로 구분)를 설정해 관리자 접근을 부트스트랩하세요.

3b. 이메일(인증 확인 및 비밀번호 재설정)

인증 이메일은 이 앱이 아니라 Supabase가 보냅니다. 새 계정에 검증 이메일이 도착하지 않는다면 이는 Supabase 설정 문제입니다 — 대부분 사용자 SMTP가 구성되지 않았기 때문 입니다(기본 제공 발신자는 테스트 전용으로 시간당 몇 건만 허용됩니다). Supabase 대시보드: Authentication → Emails → SMTP Settings(Resend/Postmark/SendGrid/SES) 구성, Providers → Email에서 Confirm email 활성화, URL Configuration 허용 목록에 사이트 URL과 …/auth/callback 추가.

4. 클라이언트 연결

claude mcp add --transport http sme-library \
  https://<deployment>/api/mcp \
  --header "Authorization: Bearer sme_live_..."

Claude Desktop, claude.ai 커스텀 커넥터, 그리고 Streamable HTTP MCP 클라이언트와 함께 사용할 수 있습니다.

로컬 개발

cp .env.example .env      # fill in Supabase + Anthropic
npm install
npm run dev               # HTTP server on :3000 (endpoint: /api/mcp)
SME_API_KEY=sme_live_... npm run stdio   # or stdio transport for local clients

보안 모델

• API 키는 저장 시 SHA-256으로 해시 처리되고 Authorization 헤더로만 전달됩니다. 자격 증명은 도구 인수나 모델 컨텍스트에 절대 나타나지 않습니다.

• 모든 키는 범위(read, write, promote, admin)와 속도 제한 등급이 있는 하나의 워크스페이스에 매핑됩니다. 키별 고정 윈도 상한은 Postgres에서 적용됩니다.

• Supabase RLS는 모든 테이블에서 deny-all으로 활성화되어 심층 방어 방어로 줄 역할을 합니다. 서버의 서비스 역할 클라이언트만 읽고 쓸 수 있습니다.

• 모든 쓰기는 audit_log에 기록됩니다.