SME Library MCP

一个免费、开源的 MCP 服务器，用于创建、搜索和共享领域专家（SME）档案，供 AI 智能体查阅。任何人都可以接入服务器，从共享库中拉取经审核的专家档案，在自己的工作区中维护私有档案，并通过人工审核的推广流程把优质档案贡献回共享库——也可以自托管整个技术栈。

在 MIT License 下授权。欢迎通过 issues 和 pull requests 贡献。

运行基于 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 密钥

自助申请（推荐）： 访问 /dasboard，用 Supabase Auth 创建一个账号，然后滚动生成密钥。前提是为项目设置好 SUPABASE_ANON_KEY 并且打开邮箱认证。

运维 / 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_ANON_KEY、SUPABASE_SERVICE_ROLE_KEY、SUPABASE_ANON_KEY（为仪表盘提供支持）、ANTHROPIC_API_KEY，以及 CRON_SECRET——后者保护每天处理的 /api/cron/maintenance 任务（该任务负责重新计算质量分、清理过期限流介质窗口，并回填 embedding 向量）。同时把 NEXT_PUBLIC_BASE_URL 设为你的站点正式 URL，设置 ADMIN_EMAILS（按逗号分隔）以初始化管理员权限。

3b. 邮箱（确认邮件与密码重置）

认证邮件由 Supabase 发送（而非本应用）。如果新账号收不到验证邮件，那就是 Supabase 配置问题——最常见的是自定义 SMTP 未配置（内置发件方存在每小时几条的发送瓶颈，仅适合测试）。请在 Supabase 控制台的 Authentication → Emails → SMTP Settings 中完成配置（支持 Resend/Postmark/SendGrid/SES），并在 Providers → Email 下开启 confirm email，再在 Directory → Applications 的身份保持选项中将站点及 …/auth/callback 添加到 URL Configuration 允许列表。

4. 连接客户端

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

可运行于 Claude Code、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 请求头中——密钥绝不可能出现在 tool 参数或模型的上下文中。

• 每个密钥对应一个工作区，包含作用域（read、write、promote、admin）和限流档位；Postgres 会强制按“密钥 + 固定时间窗口”执行限流。

• Supabase RLS 在所有表上默认 deny-all 采用 enable-all——作为纵深防御机制，读写均由 Service 角色的官方客户端签名完成。

• 所有写操作都会记录到 audit_log。