Sovereign AI MCP

AI 에이전트에게 Sovereign AI 블로그를 노출하는 MCP 서버입니다. 이 블로그는 NVIDIA DGX Spark(GB10/SM121A)에서 자체 호스팅되는 AI에 대한 실무 엔지니어링 로그입니다.

라이브 엔드포인트: https://mcp.sovgrid.org/self-hosted-ai 전송 방식: Streamable HTTP (FastMCP) 인증: 없음 (무료 티어, IP당 분당 60회 요청)

사용 이유

틈새 하드웨어(GB10, SM121A, ARM64 기반 SGLang)에 대한 학습 데이터는 부족하고 오래되었습니다. 이 MCP는 에이전트가 실제 설정, 수정 사항 및 벤치마크를 문서화한 44개 이상의 기사에 직접적이고 구조화된 방식으로 접근할 수 있게 해줍니다. 유사한 스택에서 빌드하거나 디버깅하는 경우, 에이전트가 환각을 일으키는 대신 검증된 최신 정보를 가져올 수 있습니다.

Related MCP server: mcp-astgl-knowledge

도구

빠른 시작

Claude Code 사용 시

claude mcp add sovereign-ai --transport http https://mcp.sovgrid.org/self-hosted-ai

확인:

claude mcp list | grep sovereign-ai

Cline / Continue / 기타 MCP 클라이언트 사용 시

클라이언트의 MCP 서버 구성에 다음을 추가하세요:

{
  "sovereign-ai": {
    "type": "http",
    "url": "https://mcp.sovgrid.org/self-hosted-ai"
  }
}

로컬 실행

소스에서 실행 (uv)

git clone https://github.com/cipherfoxie/sovereign-mcp.git
cd sovereign-mcp
uv sync
uv run uvicorn src.main:app --host 127.0.0.1 --port 8002

Docker

git clone https://github.com/cipherfoxie/sovereign-mcp.git
cd sovereign-mcp
docker build -t sovereign-mcp .
docker run -p 8002:8002 sovereign-mcp

이 저장소는 서버가 즉시 시작되고 MCP 인트로스펙션에 깔끔하게 응답할 수 있도록 플레이스홀더 data/knowledge-base.json(기사 0개, 유효한 스키마)을 포함하고 있습니다. 실제 콘텐츠로 채우려면 sovgrid.org 블로그 소스에서 scripts/generate_knowledge_base.py를 사용하여 생성하거나, src/knowledge.py의 스키마에 맞는 자체 KB를 빌드하세요. 또는 https://mcp.sovgrid.org/self-hosted-ai의 라이브 엔드포인트를 사용하세요.

아키텍처

• FastMCP 1.27+ (경로 /self-hosted-ai에서 Streamable HTTP 전송 사용)

• DNS 리바인딩 보호: TransportSecuritySettings를 통해 Host: mcp.sovgrid.org(또는 상태 확인을 위한 localhost)인 요청만 허용

• 상태 확인 엔드포인트: /health에서 기사 수 및 KB 생성 타임스탬프 반환

• 지식 베이스: 블로그 마크다운 콘텐츠에서 생성된 플랫 JSON 파일; 시작 시 로드되며 search_blog를 위해 TF-IDF로 쿼리됨

서버는 상태 비저장(stateless) 방식입니다. 모든 블로그 콘텐츠는 이미 공개되어 있습니다(CC BY-SA 4.0). PII, 인증 토큰, 비밀 정보는 없습니다.

운영

라이브 배포는 Docker를 통해 개인정보 보호 중심의 유럽 VPS에서 실행되며, Caddy와 TLS로 보호됩니다. 서버 로그는 개인정보를 존중하는 분석 파이프라인으로 흐릅니다(Caddy JSON 액세스 로그, 클라이언트 측 추적 없음, JS 픽셀 없음).

라이선스

• 서버 코드: MIT, LICENSE 참조

• 블로그 콘텐츠(도구에 의해 반환됨): CC BY-SA 4.0, creativecommons.org/licenses/by-sa/4.0/ 참조

연락처

• 블로그: sovgrid.org

• Nostr: cipherfox@sovgrid.org (NIP-05) — npub1ndrjgfcwkc0y4753zyj3p7qjf795pvjq2dn4m7y7f72vmu7t0nrs6y363u

• 버그 리포트 / 질문: 이슈 열기