用途：sovereign-mcp 是一个 MCP 服务器，将 Sovereign AI Blog 暴露给 AI 智能体。该博客是关于在 NVIDIA DGX Spark（GB10/SM121A）上进行自托管 AI 的实践工程日志。由于针对 GB10、SM121A、ARM64 上的 SGLang 等小众硬件的训练数据稀少且过时，该 MCP 为智能体提供对 180 多篇文章的直接、结构化访问，记录真实配置、修复与基准测试。若你在类似技术栈上构建或调试，智能体可以拉取经过验证、版本最新的信息，而不是产生幻觉。
主要内容覆盖：GB10 的 SGLang 与 vLLM 补丁、ARM64 上的 voxtral 与 TTS 流水线、KV-cache 与量化权衡、播客级音频生成、MCP 服务器设计、知识库构建，以及在加固的欧洲 VPS 上运行这些系统的运维方面。
主要能力：提供搜索、检索和诊断工具。所有工具为只读、幂等，并通过 ToolAnnotations 声明，使 MCP 客户端可以校准重试策略和信任信号。输入使用 Pydantic Annotated[type, Field(description=...)]，使参数文档可通过内省传递给智能体。输出为类型化的 BaseModel 形状——schema 真实存在，不是空洞的 dict。
使用方式：
- 实时端点：https://mcp.sovgrid.org/self-hosted-ai，传输方式为 Streamable HTTP（FastMCP），认证：无（免费层，60 请求/分钟/IP）。
- 与 Claude Code 配合使用。
- 与 Cline / Continue / 其他 MCP 客户端配合使用：添加到客户端的 MCP 服务器配置中。
- 从源码构建（uv）：仓库附带占位符 data/knowledge-base.json（零文章，但 schema 有效），使服务器开箱即可启动并干净地响应 MCP 内省。要填充真实内容，可使用 scripts/generate_knowledge_base.py 从 sovgrid.org 博客源生成，或按 src/knowledge.py 中的 schema 构建自己的知识库。
技术细节：FastMCP 1.27+ 使用 Streamable HTTP 传输，路径为 /self-hosted-ai；通过 TransportSecuritySettings 提供 DNS 重绑定保护，仅允许 Host: mcp.sovgrid.org 的请求（健康检查允许 localhost）；健康端点 /health 返回文章数量和知识库生成时间戳；知识库是从博客 Markdown 内容生成的扁平 JSON 文件，启动时加载，通过 TF-IDF 供 search_blog 查询。服务器无状态。所有博客内容已公开（CC BY-SA 4.0）。无 PII、无认证令牌、无机密。实时部署通过 Docker 运行在注重隐私的欧洲 VPS 上，由 Caddy 提供 TLS 前端。服务器日志流入尊重隐私的分析管道（Caddy JSON 访问日志，无客户端跟踪，无 JS 像素）。
授权与许可：服务器代码为 MIT（见 LICENSE），工具返回的博客内容为 CC BY-SA 4.0。博客：sovgrid.org。Nostr：cipherfox@sovgrid.org（NIP-05）— npub1ndrjgfcwkc0y4753zyj3p7qjf795pvjq2dn4m7y7f72vmu7t0nrs6y363u。Bug 报告/问题：提交 issue。
限制：免费层限速 60 请求/分钟/IP，无认证。仓库默认知识库为空（占位符），需自行生成或使用实时端点。
