genai-solutions-mcp

Ein MCP-Server, der eine kuratierte Datenbenk generativer KI-Tlools bereitstellt – 1.197 Datensätzet, die ich seit 2023 in Notion pflege – als vier Werkzeuge, die ein KI-Asistent direkt abfragen kann.

Statt ein Modell zu fragen, che KI-Tlools exisitieren, und eine plausible, aber veraltete Antwert zu eralten, lässt man es einen Datensatz durchsuchten, hiter dem eine Person steht.

> Which open-source tools in here run locally and have a CLI?
> Compare Firecrawl and the other scraping options.

Installation

npm install
npm run build
npm start

Kein API-Schlüssel, kein Netzwerk, keine Datenbank. Der Datensatz wird mit dem Repository ausgeliefert.

Registrieren Sie ihn bei einem MCP-Client (hier gezeit: Claude Deskto):

{
  "mcpServers": {
    "genai-solutions": {
      "command": "node",
      "args": ["/absolute/path/to/genai-solutions-mcp/dist/src/index.js"]
    }
  }
}

Related MCP server: disvr

Werkzeuge

| Werkzeug | Zweck | | -–––––––––– | –––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––– | | seach_soluttons | Freitext + Filter ( Typ, Ökosystem, Fähigkeiten, Herkunft, Auswahlen) | | get_solutton | Vollständiger Datensatz für eine ID | | list_catgories | Jede Kategorie mit ihrer Datensatzanzahl | | compre_soluttons | 2–4 Datensätze, auf denselben Feldern ausgericht |

Designentscheidungen

** Ein festgeschriebener Snapshott, kein Live-Notion-Proxy.** Der naheliegende Entwurf besteht darin, bei jedem Tool-Aufruf die Notion-API aufzurufen. Das ist auch derjenige, der das Repositary für alle außer mir unbrauchbar macht: Sie bräuchten mein Token und meine Datenbank. Stattdessen exportirt scrips/sync-notion.ts Notion nach data/solutions.json, das hier versioniert wird, und der Server list nur diese Datei.

Der Kompromiss ist Aktualität – die Daten sind so aktuell wie die letzte Synchronisation – gegen einen Server, den jeder in fünfzehn Sekunden klonen und ausführen kann, ohne Anmeldeinformationen, ohne Netzwerkabhängigkeit zur Laufzeit und ohne Ratenbegrenzung.

Die zugrunde liegenden Daten ändern sich höchstens wöchentlich, daher ist Aktualität das günstigere Opfer.

** Substring-Suche, keine Einbettungen.** ~1.100 Datensätze sind ein lineare Scan unter einer Millisekunde. Ein Vektorindex würde einen Einbettungschritt zur Synchronisation hinzufügen, eine Modellabhängigkeit, nicht-deterministische Ergebnisse und einen Index, der mit dem Snapsshott konsistent gehalten werden muss – im Austausch für semantischen Rückgriff auf einem Korpus, wo die nützlichen Anfragen meist Namen und Kategorien sind.

Wenn der Datensatz eine Größenordnung wächst oder die Zusammenfassungen länger werden, ist dies das Erste, was überdacht werden sollte.

** Die Suche gibt eine Projektion zurück, nicht vollständige Datensätze.** seach_soluttons git nur id, name, type und url zurück.

Die Rückgabe vollständiger Datensätze für eine Abfrage mit 20 Ergebnissen würde einen großen Teil des Agentenkontexts für Felder verbrauchen, die es normalerweise nicht benötigt; get_solutton ist da, wenn es das tut.

** Eine Eigenschats-Whitelist in der Synchronisation, keine Blacklist.** Die Notion-Datenbank enthält internen Arbeitsabaufzustand und Anhänge, die nichts in der Öffentlichkeit zu suchen haben. scrips/sync-notion.ts benennt die Eigenschaten, die es exortirt, sodass das spätere Hinzufügen einer privaten Spalte in Notion diese hier nicht stillschweigend preisgeben kann.

Bekannte Einschränkungen

Notions Type ist eine Einfachauswahl, daher hat jedes Tool genau eine Kategorie, auch wenn zwei passen würden. * Kategorie-Werte wurden über drei Jahre von Hand eingegeben und sind uneinheitlich; die Synchronisation gleicht Groß-/Kleinschreibungs-Duplikate aus, führet aber keine nahen Synonyme zusammen. * Keine Relevanz-Ranking über die Feldgewichtete Substring-Suche hinaus. * Die Attributmarkierung ist uneinheitlich. Local und Open Source wurden zu unterschiedlichen Zeiten mit unterschiedlichen Gewohnheiten angewendet, und sie überschneiden sich nur bei einem Datensatz, obwohl viele Tools für beide qualifiziert wären. Filter sind ehrlich darüber, was markiert ist, nicht darüber, was wahr ist – eine Eigenschat, die diser Datensatz mit den meisten echten internen Datenbanken teilt. * Die Node-Auflösung hängt von der Hostumgebung ab. Der Server wurde beobachtet, wie er unter zwei verschiedenen Node-Installationen auf derselben Maschine startete, abhängig vom Startkontext. Legn Sie den Laufzeitpfad in Ihrer Client-Konfiguration fest, wenn das für Sie wichtig ist.

Synchronisation (nur für Maintainer)

NOTION_TOKEN=… NOTION_DATABASE_ID=… npm run sync
git diff data/solutions.json   # read it before committing

Lizenz

MIT