nei-mcp-server

Ein auf fastmcp basierender Tool-Server für die Interaktion mit der NEI-Plattform, der Funktionen zur Abfrage von NEI-Projektressourcen bereitstellt.

Kernfunktionen

Dieses Projekt kapselt häufig verwendete Funktionen der NEI-Plattform in eine Reihe von MCP-Tools, um eine schnelle Abfrage und Integration zu ermöglichen. Die unterstützten Tools sind:

• sync_nei_project: Erzwingt die Synchronisierung der neuesten Projektdaten von der entfernten NEI-Plattform und aktualisiert den lokalen Cache. Wenn der Verdacht besteht, dass die lokalen Daten nicht aktuell sind oder kürzlich geänderte Backend-Schnittstellen oder Datenmodellinformationen abgerufen werden müssen, sollte dieses Tool zuerst aufgerufen werden.

• search_interfaces_by_uri: Führt eine unscharfe Suche nach Schnittstellenressourcen im NEI-Projekt basierend auf der URI (Schnittstellenpfad) der Schnittstellendefinition durch.

• search_interfaces_by_url: Führt eine präzise Suche nach Schnittstellenressourcen basierend auf pid und id aus dem Link zur NEI-Schnittstellendetailseite durch, z. B. http://nei.example.com/interface/detail/?pid=10135&id=13015.

• search_interfaces_by_name: Führt eine unscharfe Suche nach Schnittstellenressourcen im NEI-Projekt basierend auf dem Schnittstellennamen durch.

• search_groups_by_name: Sucht nach Geschäftsgruppen im NEI-Projekt basierend auf dem Gruppennamen.

Related MCP server: YApi MCP Server

Umgebungsvorbereitung

• Node.js (v20 oder höher empfohlen)

• pnpm (optional, empfohlen)

Installation und Konfiguration

1. Projekt klonen

   git clone https://github.com/leila-huang/nei-mcp-server.git
   cd nei-mcp-server

2. Abhängigkeiten installieren Mit npm:

   npm install

   Oder pnpm:

   pnpm install

Debugging-Tools

1. inspect Debugging Mit dem inspect-Befehl von fastmcp können alle Tools lokal und interaktiv getestet werden. SERVER_URL und PROJECT_ID müssen im Webinterface konfiguriert werden.

   npm run inspect

   Dieser Befehl stellt eine interaktive Oberfläche bereit, in der Sie die auszuführenden Tools auswählen und Parameter eingeben können, was sich hervorragend zum Debuggen und Erkunden eignet.

2. mcp Client-Debugging

       {
         "mcpServers": {
             "nei-mcp-server": {
                 "command": "npx",
                 "args": ["tsx", "/PATH/TO/YOUR_PROJECT/src/index.ts"],
                 "env": {
                     "SERVER_URL": "xxx",
                     "PROJECT_ID": "xxx"
                 }
             }
         }
       }

mcp Benutzerhandbuch

```bash
{
    "mcpServers": {
        "nei-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@leila329/nei-mcp-server"
            ],
            "env": {
                "SERVER_URL": "xxx",
                "PROJECT_ID": "xxx"
            }
        }
    }
}
```

Cache-Mechanismus

Um die Leistung zu verbessern und die Belastung des NEI-Servers zu reduzieren, implementiert dieses Projekt eine einfache Cache-Strategie:

1. Speicher-Cache: Daten werden nach dem ersten Laden im Arbeitsspeicher gespeichert. Während einer einzelnen Laufzeit des Dienstes werden nachfolgende identische Anfragen direkt aus dem Speicher beantwortet, um wiederholte Netzwerkanfragen zu vermeiden. Nach einem Neustart des Dienstes wird der Speicher-Cache geleert.

2. Netzwerksynchronisierung: Beim Start des Dienstes oder beim manuellen Aufruf des Tools sync_nei_project werden die neuesten Projektdaten vom entfernten NEI-Server abgerufen und der Speicher-Cache aktualisiert.

Sie können die Netzwerksynchronisierung manuell erzwingen, indem Sie das Tool sync_nei_project aufrufen, um sicherzustellen, dass die Daten auf dem neuesten Stand sind.