MCP-Unternehmenssuche

Dieses MCP (API Connection Module) ermöglicht Ihnen die Interaktion mit der von data.gouv.fr bereitgestellten Business Search API.

Beschreibung

Mit der Business Search API können Sie französische Unternehmen suchen und finden. Es bietet zwei Arten der Suche:

Textsuche (Name, Adresse, Führungskräfte und gewählte Amtsträger)
Geografische Suche

Merkmale

Mit dem MCP können Sie:

Suche nach Unternehmen nach verschiedenen Kriterien
Filtern Sie die Ergebnisse nach mehreren Parametern
Zugriff auf wichtige Unternehmensinformationen (Name, SIREN-, SIRET-, NAF-Code)
Führen Sie geografische Suchen rund um einen Punkt mit den folgenden Parametern durch:
- Breitengrad und Längengrad des Suchpunkts
- Suchradius (bis zu 50km)
- Aktivitätsfilter (NAF-Code, Aktivitätsabschnitt)
- Paginierung der Ergebnisse

Quelle

Dieses MCP basiert auf der offiziellen API von data.gouv.fr: Business Search API

Einschränkungen

Die API weist einige Einschränkungen auf:

Bietet keinen Zugang zu Vorgängern und Nachfolgern einer Niederlassung
Erlaubt keinen Zugriff auf nicht verbreitbare Unternehmen
Ermöglicht keinen Zugriff für Unternehmen, deren Registrierung im RCS abgelehnt wurde
Der geografische Suchradius ist auf maximal 50 km begrenzt

Technische Einschränkungen

Limit von 7 Anrufen pro Sekunde
Verfügbarkeit: 100 % im letzten Monat
Zugang: Offen für alle

Verwenden

Als Benutzer

Der einfachste Weg, dieses MCP zu verwenden, ist über npx :

npx mcp-recherche-entreprises

Als Entwickler

Abhängigkeiten installieren:

npm install

Projektaufbau:

npm run build

Dieser Befehl führt Folgendes aus:

Kompilieren Sie TypeScript-Dateien in JavaScript
Platzieren Sie sie im Ordner dist/
Machen Sie JavaScript-Dateien ausführbar

Start-up :

So starten Sie den Server im Entwicklungsmodus mit dem MCP Inspector (für die Entwicklung empfohlen):

npm run dev

So starten Sie den Server ohne den Inspector:

npm start

Der MCP Inspector bietet eine grafische Benutzeroberfläche zum Testen und Debuggen von MCP-Anfragen in Echtzeit.

Mit Cursor verwenden

Um dieses MCP in Cursor zu verwenden, fügen Sie Ihrer Datei .cursor/settings.json die folgende Konfiguration hinzu:

{
  "mcpServers": {
    "recherche-entreprises": {
      "command": "npx mcp-recherche-entreprises"
    }
  }
}

Diese Konfiguration ermöglicht es Cursor, dieses MCP automatisch für Geschäftssuchen zu verwenden.

MCP-Ressourcen für Mitwirkende

Offizielle Dokumentation

Entwicklungstools

MCP TypeScript SDK
MCP Inspector – Debugging- und Analysetool

Bewährte Methoden

Verwenden Sie das TypeScript SDK zur Implementierung
Befolgen Sie die Projektcodekonventionen
Implementieren Sie eine robuste Fehlerbehandlung
Dokumentieren Sie die API klar
Bewahren Sie die Kompatibilität mit zukünftigen Versionen

Testen und Debuggen

Verwenden des Inspectors zum Debuggen
Implementieren von Unit-Tests
Überprüfen Sie die Einhaltung der MCP-Spezifikation
Analysieren Sie die Leistung mit den entsprechenden Tools

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Weitere Einzelheiten finden Sie in der Datei LICENSE .

Beitrag

Beiträge sind willkommen! Weitere Informationen dazu, wie Sie zu diesem Projekt beitragen können, finden Sie in unserem Beitragsleitfaden .

MCP Recherche d'entreprises