Multi-Provider MCP Server

マルチプロバイダー MCP サーバー

複数のツールプロバイダーに対応した、堅牢で拡張性の高い Model Context Protocol（MCP）サーバーです。このサーバーを使用すると、AI モデルは標準化されたインターフェースを通じて、さまざまなサービスプロバイダーのツールを利用できます。

特長

• 新しいプロバイダーを簡単に追加できるモジュール式アーキテクチャ
• 一元化された構成管理
• プロバイダー固有のツール実装
• ツールを直接テストできる CLI モード
• 包括的なエラー処理とログ記録

対応プロバイダー

現在、サーバーは以下のプロバイダーに対応しています。

• Evolution API：WhatsApp のメッセージ送信とグループ管理のためのツール

はじめに

前提条件

• Node.js 14.x 以降
• npm または yarn

インストール

1. リポジトリをクローンします
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() {
    // Register your tools here
  }
}

module.exports = MyNewProvider;

アーキテクチャ

├── src/
│   ├── config/             # Configuration settings
│   ├── core/               # Core server functionality
│   │   ├── BaseProvider.js # Base class for providers
│   │   ├── MCPServer.js    # MCP server implementation
│   │   └── ProviderManager.js # Manages all providers
│   ├── providers/          # Provider implementations
│   │   ├── EvolutionProvider.js  # Evolution API provider
│   │   └── index.js        # Provider exports
│   ├── utils/              # Utility functions
│   │   ├── httpClient.js   # HTTP client wrapper
│   │   └── logger.js       # Logging utility
│   └── index.js            # Application entry point
├── .env                    # Environment variables
├── .env.example            # Environment variables template
└── package.json            # Project metadata

ライセンス

ISC