Multi Provider MCP Server

🚀 多提供者 MCP サーバー

強力で拡張性の高いモデルコンテキストプロトコル（MCP）サーバーで、複数のツールプロバイダーをサポートしています。このサーバーにより、AI モデルは標準化されたインターフェースを通じて、異なるサービスプロバイダーのツールを使用することができます。

✨ 主な機能

• 新しいプロバイダーを簡単に追加できるモジュール化されたアーキテクチャ
• 集中的な設定管理
• プロバイダー固有のツール実装
• ツールを直接テストするための CLI モード
• 完全なエラー処理とロギング

📦 サポートされているプロバイダー

現在、サーバーは以下のプロバイダーをサポートしています。

• 進化 API：WhatsApp のメッセージ送信とグループ管理に適したツール

🚀 クイックスタート

前提条件

• Node.js 14.x 以上
• npm または yarn パッケージマネージャー

インストール

1. リポジトリをクローンします。

   git clone <repository-url>
   cd <repository-directory>
   

2. 依存関係をインストールします。

   npm install
   

3. テンプレートから .env ファイルを作成します。

   cp .env.example .env
   

4. .env ファイルで環境変数を設定します。

サーバーの起動

開発モードでサーバーを起動します。

npm run dev

または、本番モードで起動します。

npm start

CLI モードを使用したツールのテスト

任意のツールを直接テストすることができます。

npm run tool <tool_name> '<json_args>'

例：

npm run tool envia_mensagem '{"number":"5511999999999","mensagem":"Hello world!"}'

🔧 新しいプロバイダーの追加

1. src/providers ディレクトリに、BaseProvider を継承した新しいプロバイダークラスを作成します。
2. 必要なツールとそのハンドラーを実装します。
3. src/providers/index.js でプロバイダーを登録します。
4. src/config/index.js のプロバイダー設定を更新します。
5. .env.example ファイルを変更して、新しい変数を含めます。

プロバイダーテンプレート

const BaseProvider = require('../core/BaseProvider');

class MyNewProvider extends BaseProvider {
  constructor(config) {
    super('provider-name', config);
    this._registerTools();
  }
  
  _registerTools() {
    // ここでツールを登録します
  }
}

module.exports = MyNewProvider;

🔧 アーキテクチャ

├── src/
│   ├── config/             # 設定
│   ├── core/               # サーバーのコア機能
│   │   ├── BaseProvider.js # プロバイダーの基底クラス
│   │   ├── MCPServer.js    # MCP サーバーの実装
│   │   └── ProviderManager.js # すべてのプロバイダーを管理
│   ├── providers/          # プロバイダーの実装
│   │   ├── EvolutionProvider.js  # 進化 API プロバイダー
│   │   └── index.js        # プロバイダーのエクスポート
│   ├── utils/              # ユーティリティ関数
│   │   ├── httpClient.js   # HTTP クライアントラッパー
│   │   └── logger.js       # ログツール
│   └── index.js            # アプリケーションのエントリーポイント
├── .env                    # 環境変数ファイル
├── .env.example            # 環境変数のテンプレート
└── package.json            # プロジェクトのメタデータ

📄 ライセンス

ISC