Servidor MCP de búsqueda de conocimiento de AIニケちゃん

Es una herramienta no oficial. Este proyecto no está aprobado, afiliado ni patrocinado por AIニケちゃん, sus operadores, X, OpenAI ni las empresas u organizaciones relacionadas. Los derechos sobre los nombres, publicaciones, sitios web y demás fuentes pertenecen a sus respectivos titulares.

Es un servidor para Next.js / Vercel que permite buscar información pública sobre AIニケちゃん desde clientes MCP (Model Context Protocol). Las consultas se vectorizan mediante OpenAI Embeddings a través de Vercel AI Gateway, y los resultados de búsqueda incluyen la URL de la fuente y la fecha y hora de la publicación.

Lo que no se incluye en el repositorio público

En este repositorio nunca se hace commit de lo siguiente:

• Los datos recopilados de publicaciones de X y sus textos derivados

• Los metadatos de búsqueda que incluyen el texto de las publicaciones y los vectores generados

• Los archivos de variables de entorno tipo .env, claves de API y tokens de autenticación

Estos elementos están excluidos mediante .gitignore y .vercelignore. En los despliegues públicos, el índice generado se carga desde Private Vercel Blob, por lo que los datos de las publicaciones no se incluyen en el repositorio ni en los artefactos de las Functions.

Publicación de la demo y seguridad

Este proyecto expone el endpoint MCP sin autenticación para una demo pública de corta duración. En Vercel se registran AI_GATEWAY_API_KEY y la configuración de almacenamiento que se añade al conectar Private Blob. No guarde los valores en GitHub, en el código del cliente ni en los registros.

AI_GATEWAY_API_KEY=
BLOB_READ_WRITE_TOKEN=

Dado que terceros también pueden ejecutar búsquedas, se generarán costos de uso de AI Gateway. Acorte el período de publicación, configure el WAF y los límites de tasa en Vercel y supervise el uso. Detenga el despliegue cuando termine la demo.

Se han detectado valores que parecen credenciales en el .env de esta carpeta de trabajo. Antes de añadirlos a Git, compruebe si están en uso actualmente y, si es necesario, rote las claves.

Desarrollo local

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

El endpoint de búsqueda local es http://localhost:3000/api/mcp. Para generar el índice se necesitan localmente los datos de publicaciones de X excluidos.

Colocación del índice en Vercel Blob

1. Desde Storage del proyecto de Vercel, cree un almacén de blobs con acceso Private y conéctelo al proyecto.

2. Obtenga las variables de entorno de Vercel en local y establezca BLOB_READ_WRITE_TOKEN en el .env.local.

3. Tras generar el índice en local, ejecute lo siguiente:

npm run upload:index

indexes/metadata.json y indexes/embeddings.f32 se suben a Private Blob. En el entorno de Vercel se cargan estos dos archivos, mientras que en el entorno local se cargan los archivos de src/data como hasta ahora. Solo si cambia las rutas dentro del Blob, configure VECTOR_INDEX_METADATA_PATH y VECTOR_INDEX_VECTORS_PATH con el mismo valor tanto en local como en Vercel.

Herramientas MCP

• search_nikechan_knowledge: búsqueda semántica en publicaciones de X y el sitio oficial

• search_x_posts: búsqueda semántica solo en publicaciones de X

• search_hybrid: búsqueda que combina coincidencia de palabras clave y búsqueda semántica

• search_keywords: búsqueda por palabras clave

• search_timeline: búsqueda por período o año/mes

• get_popular_posts: búsqueda ordenada por número de reacciones

• get_x_post / get_x_thread: obtención de una publicación o un hilo

• x_posts_dataset_info: consulta del número de elementos y la estructura del índice

Los resultados son información de referencia basada en fuentes públicas. No se garantiza su exactitud, integridad ni actualidad, por lo que en las respuestas debe consultar la fuente original de las URL devueltas.

Verificación

npm run lint
npm test
npm run build

Aspectos conocidos a verificar antes del despliegue

La auditoría de dependencias muestra vulnerabilidades de alta severidad relacionadas con Next.js. Como corregirlas implica un cambio disruptivo a Next.js 16, este repositorio no las actualiza automáticamente. Antes de publicar en producción en Vercel, actualice Next.js tras verificar la compatibilidad y vuelva a ejecutar npm audit --omit=dev --audit-level=high.