SME Library MCP

Бесплатный MCP-сервер с открытым исходным кодом для создания, поиска и обмена профилями экспертов в предметной области, к которым могут обращаться ИИ-агенты. Любой желающий может подключить своего агента, получить проверенных экспертов из общей библиотеки, вести приватных экспертов в собственном рабочем пространстве и возвращать лучших обратно через модерируемый конвейер публикации — или развернуть весь стек у себя.

Лицензирован по MIT License. Приветствуются вклады через issues и pull requests.

Работает на Vercel (Next.js + Streamable HTTP transport) с бэкендом на Supabase. Впервые здесь? Прочитайте Руководство пользователя — там описано, как всё работает, и дан полный справочник по каждому полю 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

Edge-функция embed запускает встроенную модель gte-small. Она необязательна — без неё поиск автоматически переходит на поиск по ключевым словам FTS.

2. Получение API-ключа

Самостоятельно (рекомендуется): зайдите на /dashboard, создайте аккаунт (Supabase Auth) и выпустите ключ. Первый вход автоматически создаёт ваше рабочее пространство. Требуется, чтобы был задан SUPABASE_ANON_KEY и в проекте Supabase была включена email-авторизация.

Оператор / 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 (защищает ежедневную задачу /api/cron/maintenance, которая пересчитывает показатели качества, очищает окна rate-limit и дополняет embeddings). Также задайте NEXT_PUBLIC_BASE_URL — канонический URL сайта — и ADMIN_EMAILS (через запятую) для первичного назначения администраторов.

3b. Email (подтверждения и сброс пароля)

Письма для аутентификации отправляются Supabase, а не этим приложением. Если новые аккаунты не получают письма для подтверждения, это проблема конфигурации Supabase — чаще всего означает, что не настроен custom SMTP (встроенный отправитель ограничен несколькими письмами в час и подходит только для тестов). В панели Supabase: настройте Authentication → Emails → SMTP Settings (Resend/Postmark/SendGrid/SES), включите Confirm email в разделе Providers → Email и добавьте свой сайт и …/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 и любым MCP-клиентом Streamable-HTTP.

Локальная разработка

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) и уровнем rate-limit; для каждого ключа в Postgres действуют лимиты fixed-window.

• В Supabase включена RLS с политикой deny-all на каждой таблице — это дополнительная защита малой глубиной; читать и записывать может только серверный клиент с ролью service-role.

• Все операции записи попадают в audit_log.