MCPビジネスサーチ

この MCP (API 接続モジュール) を使用すると、data.gouv.fr が提供するビジネス検索 API と対話できます。

説明

Business Search API を使用すると、フランスの企業を検索して見つけることができます。次の 2 種類の検索が提供されます。

テキスト検索（名前、住所、指導者、選出された役人）
地理検索

特徴

MCP を使用すると次のことが可能になります。

さまざまな基準で企業を検索する
複数のパラメータで結果をフィルタリングする
重要な企業情報（名前、SIREN、SIRET、NAF コード）にアクセスします
次のパラメータを使用して、ポイントの周囲の地理検索を実行します。
- 検索地点の緯度と経度
- 検索半径（最大50km）
- アクティビティフィルター (NAF コード、アクティビティセクション)
- 結果のページネーション

ソース

このMCPは、公式data.gouv.fr API（ビジネス検索API）に基づいています。

制限事項

API にはいくつかの制限があります。

設立の前身や後継者へのアクセスを提供しない
非配布企業へのアクセスは許可しません
RCSへの登録を拒否された企業へのアクセスは許可されません
地理的な検索範囲は最大50kmに制限されています

技術的な制限

1秒あたり7回の呼び出しの制限
可用性: 過去 1 か月間で 100%
アクセス: 誰でも利用可能

使用

ユーザーとして

この MCP を使用する最も簡単な方法はnpxを使用することです。

npx mcp-recherche-entreprises

開発者として

依存関係のインストール:

npm install

プロジェクトビルド:

npm run build

このコマンドは次のことを行います。

TypeScriptファイルをJavaScriptにコンパイルする
dist/フォルダに配置します
JavaScriptファイルを実行可能にする

起動する：

MCP インスペクターを使用して開発モードでサーバーを起動するには (開発に推奨):

npm run dev

インスペクターなしでサーバーを起動するには:

npm start

MCP インスペクターは、MCP リクエストをリアルタイムでテストおよびデバッグするためのグラフィカルインターフェイスを提供します。

カーソルと一緒に使用

Cursor でこの MCP を使用するには、次の構成を.cursor/settings.jsonファイルに追加します。

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

この構成により、Cursor はビジネス検索にこの MCP を自動的に使用できるようになります。

貢献者向けMCPリソース

公式ドキュメント

開発ツール

MCP TypeScript SDK
MCP Inspector - デバッグおよび分析ツール

ベストプラクティス

実装にはTypeScript SDKを使用する
プロジェクトのコード規約に従う
堅牢なエラー処理を実装する
APIを明確に文書化する
将来のバージョンとの互換性を維持する

テストとデバッグ

デバッグにインスペクタを使用する
ユニットテストを実装する
MCP仕様への準拠を確認する
適切なツールでパフォーマンスを分析する

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。詳細については、 LICENSEファイルを参照してください。

貢献

貢献を歓迎します!このプロジェクトに貢献する方法の詳細については、貢献ガイドをご覧ください。

MCP Recherche d'entreprises