Сервер MCP для поиска знаний AI-никэ-тян

Неофициальный инструмент. Этот проект не одобрен, не аффилирован и не спонсирован AI-никэ-тян, её операторами, X, OpenAI или связанными с ними компаниями и организациями. Права на названия, публикации, веб-сайты и другие источники информации принадлежат их соответствующим правообладателям.

Это сервер для Next.js / Vercel, предназначенный для поиска публичной информации об AI-никэ-тян из клиентов MCP (Model Context Protocol). Вопросы векторизуются через Vercel AI Gateway с помощью OpenAI Embeddings, а в результаты поиска включаются URL источников и даты публикаций.

Что не включается в публичный репозиторий

В этот репозиторий ни в коем случае не коммитятся следующие элементы:

• Собранные данные публикаций X и производные от них тексты

• Метаданные поиска, содержащие текст публикаций, и сгенерированные векторы

• Файлы переменных окружения типа .env, ключи API, токены аутентификации

Они исключены с помощью .gitignore и .vercelignore. В публичном развёртывании сгенерированный индекс загружается из Private Vercel Blob, поэтому данные публикаций не включаются в репозиторий или дистрибутивы функций.

Публичная демонстрация и безопасность

Этот проект предназначен для краткосрочной публичной демонстрации и публикует конечную точку MCP без аутентификации. В Vercel регистрируются AI_GATEWAY_API_KEY и настройки хранилища, добавляемые при подключении Private Blob. Не сохраняйте эти значения в GitHub, клиентском коде или журналах.

AI_GATEWAY_API_KEY=
BLOB_READ_WRITE_TOKEN=

Поскольку поиск могут выполнять и третьи лица, будут возникать расходы на использование AI Gateway. Сократите период публикации, настройте WAF и ограничение скорости на стороне Vercel, а также проверяйте использование. После завершения демонстрации остановите развёртывание.

В файле .env в этой рабочей папке обнаружены значения, похожие на учётные данные. Перед добавлением в Git проверьте, не используются ли они в настоящее время, и при необходимости выполните ротацию ключей.

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

npm install
cp .env.example .env.local
# .env.local に OPENAI_API_KEY を設定
npm run build:index
npm run dev

Локальная конечная точка поиска: http://localhost:3000/api/mcp. Для генерации индекса требуется исключённый локальный набор данных публикаций X.

Размещение индекса в Vercel Blob

1. В проекте Vercel создайте хранилище Blob с доступом Private и подключите его к проекту.

2. Получите переменные окружения Vercel локально и задайте BLOB_READ_WRITE_TOKEN в локальном файле .env.local.

3. После генерации индекса локально выполните следующее.

npm run upload:index

Файлы indexes/metadata.json и indexes/embeddings.f32 загружаются в Private Blob. В среде Vercel загружаются эти два файла, а в локальной среде, как и раньше, загружаются файлы из src/data. Задавайте VECTOR_INDEX_METADATA_PATH и VECTOR_INDEX_VECTORS_PATH одинаковыми значениями и локально, и в Vercel только в том случае, если вы меняете пути внутри Blob.

Инструменты MCP

• search_nikechan_knowledge: смысловой поиск по публикациям X и официальному сайту

• search_x_posts: смысловой поиск только по публикациям X

• search_hybrid: поиск, сочетающий совпадение по ключевым словам и смысловой поиск

• search_keywords: поиск по ключевым словам

• search_timeline: поиск по периоду / году и месяцу

• get_x_post / get_x_thread: получение публикации или ветки

• x_posts_dataset_info: проверка состава набора данных публикаций X

Результаты представляют собой справочную информацию на основе публичных источников. Точность, полнота и актуальность не гарантируются, поэтому в ответе сверяйтесь с первоисточником по возвращённому URL.

Проверка

npm run lint
npm test
npm run build

Известные моменты перед развёртыванием

Аудит зависимостей показывает оставшиеся уязвимости высокой серьёзности в семействе Next.js. Их исправление связано с разрушительными изменениями в Next.js 16, поэтому в этом репозитории автоматическое обновление не выполняется. Перед публикацией в Vercel обновите Next.js, предварительно проверив совместимость, и снова выполните npm audit --omit=dev --audit-level=high.