Multi Provider MCP Server

🚀 Multi-Provider MCP Server

A powerful and scalable Model Context Protocol (MCP) server that supports multiple tool providers. This server allows AI models to use tools from different service providers through a standardized interface.

✨ Features

• Modular architecture for easy addition of new providers
• Centralized configuration management
• Provider-specific tool implementations
• CLI mode for direct tool testing
• Comprehensive error handling and logging

📦 Supported Providers

Currently, the server supports the following providers:

• Evolution API: Tools for WhatsApp messaging and group management

🚀 Quick Start

Prerequisites

• Node.js 14.x or higher
• npm or yarn package manager

Installation

1. Clone the repository:

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

2. Install dependencies:

   npm install
   

3. Create a .env file from the template:

   cp .env.example .env
   

4. Configure environment variables in the .env file

Running the Server

Start the server in development mode:

npm run dev

Or in production mode:

npm start

Testing Tools in CLI Mode

You can directly test any tool:

npm run tool <tool_name> '<json_args>'

Example:

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

🔧 Adding a New Provider

1. Create a new provider class in the src/providers directory, inheriting from BaseProvider
2. Implement the required tools and their handlers
3. Register your provider in src/providers/index.js
4. Update the provider configuration in src/config/index.js
5. Modify the .env.example file to include new variables

Provider Template

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;

📚 Architecture

├── src/
│   ├── config/             # Configuration settings
│   ├── core/               # Core server functionality
│   │   ├── BaseProvider.js # Base provider class
│   │   ├── 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 tool
│   └── index.js            # Application entry point
├── .env                    # Environment variable file
├── .env.example            # Environment variable template
└── package.json            # Project metadata

📄 License

ISC