SME Library MCP
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。
工具
工具 | 作用域 | 功能 |
| read | 跨共享库与工作区进行全文、标签与专长搜索 |
| read | 浏览共享库/工作区内的 SME,按质量排序 |
| read | 获取一条完整档案 |
| write | 撰写一条新的工作区 SME(从 v1 起版本化管理) |
| write | 批量导入最多 200 条 SME 档案;无效行会先报告并跳过 |
| read | 将工作区 SME 导出为可直接导入的 JSON 数据 |
| write | 编辑工作区 SME;每次编辑都会生成版本历史快照 |
| write | 软删除(可恢复) |
| write | 把共享库 SME 复制为工作区内的可编辑私有副本 |
| write | AI 生成档案——先对共享库去重;受配额限制 |
| write | 为 SME 的会话表现打分,推动平滑质量分的计算 |
| write | 提名一条工作区 SME 进入共享库(自动把关 + 人工审核) |
| admin | 批准/拒绝推广队列 |
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 searchembed 边缘函数运行内置的 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。
This server cannot be deployed
Maintenance
Related MCP Connectors
- SkilderOAuthai.skilder
One place to build, share, and govern the skills and tools your AI agents use at work.
Curated knowledge API for AI agents - skill packs, semantic search, validated patterns.
Semantic search for people, projects and AI agents by task, skills and collaboration needs.
Shared, permission-aware company context for AI agents, with provenance, approvals and audit.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI agents to autonomously manage and improve execution processes for repetitive task types by storing reusable task contexts with associated artifacts (practices, rules, prompts, learnings) and providing full-text search across historical best practices.81MIT
- AlicenseAqualityAmaintenanceEnables AI agents to contribute and search a shared knowledge commons, so that solutions learned by one agent become available to all connected agents.161MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI agents to store, retrieve, and reason over typed knowledge, skills, and patterns with confidence tracking, provenance, and self-maintenance capabilities.-
- AlicenseNot gradedqualityAmaintenanceGoverned knowledge base for AI agents via the Model Context Protocol (MCP), enabling agents to search, read, and contribute persisted knowledge with versioning, audit trails, and approval workflows.57 npmMIT