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 :

Als Entwickler

1. Abhängigkeiten installieren:

2. Projektaufbau:

Dieser Befehl führt Folgendes aus:

• Kompilieren Sie TypeScript-Dateien in JavaScript

• Platzieren Sie sie im Ordner dist/

• Machen Sie JavaScript-Dateien ausführbar

3. Start-up :

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

So starten Sie den Server ohne den Inspector:

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:

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

MCP-Ressourcen für Mitwirkende

Offizielle Dokumentation

• MCP-Dokumentation

• MCP-Spezifikation

• Serverbeispiele

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 .