AIニケちゃん Wissenssuch-MCP-Server

Inoffizielles Tool. Dieses Projekt wird nicht von AIニケちゃん, deren Betreibern, X, OpenAI oder verbundenen Unternehmen und Organisationen unterstützt, gefördert oder gesponsert. Die Rechte an Namen, Beiträgen, Websites und anderen Informationsquellen liegen bei den jeweiligen Rechteinhabern.

Ein Server für Next.js / Vercel, um öffentliche Informationen über AIニケちゃん mithilfe von MCP-Clients (Model Context Protocol) zu durchsuchen. Fragen werden über das Vercel AI Gateway mithilfe von OpenAI Embeddings vektorisiert, und die Suchergebnisse enthalten Quell-URLs und Veröffentlichungszeitpunkte.

Was nicht in das öffentliche Repository aufgenommen wird

In dieses Repository werden die folgenden Dinge niemals committet:

• Gesammelte X-Beitragsdaten und daraus abgeleitete Texte

• Suchmetadaten einschließlich Beitragstexten und generierte Vektoren

• .env-Umgebungsvariablendateien, API-Schlüssel und Authentifizierungstoken

Diese werden über .gitignore und .vercelignore ausgeschlossen. Bei öffentlichen Deployments wird der generierte Index aus einem Private Vercel Blob geladen, sodass Beitragsdaten nicht in das Repository oder die Verteilungsartefakte der Funktion aufgenommen werden.

Demo-Veröffentlichung und Sicherheit

Dieses Projekt veröffentlicht den MCP-Endpunkt für eine kurzfristige öffentliche Demo ohne Authentifizierung. Bei Vercel werden AI_GATEWAY_API_KEY und die Speichereinstellungen registriert, die durch das Verbinden eines Private Blob hinzugefügt werden. Speichern Sie die Werte nicht in GitHub, im Client-Code oder in Logs.

AI_GATEWAY_API_KEY=
BLOB_READ_WRITE_TOKEN=

Da auch Dritte Suchanfragen ausführen können, entstehen Nutzungskosten für das AI Gateway. Halten Sie den Veröffentlichungszeitraum kurz, richten Sie die WAF und Ratenbegrenzung auf Vercel-Seite ein und prüfen Sie die Nutzung. Stoppen Sie das Deployment nach dem Ende der Demo.

In der .env dieses Arbeitsordners wurden Werte erkannt, die wie Anmeldeinformationen aussehen. Prüfen Sie vor dem Hinzufügen zu Git, ob sie derzeit verwendet werden, und rotieren Sie die Schlüssel bei Bedarf.

Lokale Entwicklung

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

Der lokale Such-Endpunkt ist http://localhost:3000/api/mcp. Für die Indexgenerierung werden die ausgeschlossenen X-Beitragsdaten lokal benötigt.

Ablegen des Index im Vercel Blob

1. Erstellen Sie im Storage des Vercel-Projekts einen Blob-Speicher mit Private-Zugriff und verbinden Sie ihn mit dem Projekt.

2. Rufen Sie die Vercel-Umgebungsvariablen lokal ab und setzen Sie BLOB_READ_WRITE_TOKEN in der lokalen .env.local.

3. Nachdem Sie den Index lokal generiert haben, führen Sie Folgendes aus:

npm run upload:index

indexes/metadata.json und indexes/embeddings.f32 werden in den Private Blob hochgeladen. In der Vercel-Umgebung werden diese beiden geladen, in der lokalen Umgebung werden wie bisher die Dateien aus src/data geladen. Nur wenn Sie die Pfade im Blob ändern, setzen Sie VECTOR_INDEX_METADATA_PATH und VECTOR_INDEX_VECTORS_PATH mit demselben Wert sowohl lokal als auch bei Vercel.

MCP-Tools

• search_nikechan_knowledge: Semantische Suche über X-Beiträge und die offizielle Website

• search_x_posts: Semantische Suche nur in X-Beiträgen

• search_hybrid: Suche, die Keyword-Übereinstimmung und semantische Suche kombiniert

• search_keywords: Keyword-Suche

• search_timeline: Suche nach Zeitraum und Jahr/Monat

• get_popular_posts: Suche sortiert nach Anzahl der Reaktionen

• get_x_post / get_x_thread: Abrufen eines Beitrags oder Threads

• x_posts_dataset_info: Anzahl und Aufbau des Index prüfen

Die Ergebnisse sind Referenzinformationen auf Grundlage öffentlicher Quellen. Da Richtigkeit, Vollständigkeit und Aktualität nicht garantiert werden, prüfen Sie in den Antworten die Originalquelle der zurückgegebenen URLs.

Validierung

npm run lint
npm test
npm run build

Bekannte Prüfpunkte vor dem Deployment

Bei der Prüfung der Abhängigkeiten verbleiben Schwachstellen mit hoher Schwere in der Next.js-Familie. Da die Behebung einen Breaking Change zu Next.js 16 erfordert, wird in diesem Repository nicht automatisch aktualisiert. Aktualisieren Sie vor der Produktionsveröffentlichung auf Vercel Next.js, nachdem Sie die Kompatibilität geprüft haben, und führen Sie erneut npm audit --omit=dev --audit-level=high aus.