Turbosmtp

A simple Node.js MCP (Model Context Protocol) server for sending emails and view statistics using TurboSMTP

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "debba-turbosmtp-mcp-server": {
      "command": "node",
      "args": [
        "mcp-turbosmtp-server.js"
      ]
    }
  }
}

You run a lightweight MCP server that lets other services send emails through TurboSMTP and view related statistics. It exposes a simple MCP API so you can integrate email sending into your apps, test everything quickly, and validate TurboSMTP workflows in a controlled environment.

How to use

Start the MCP server locally to expose an API you can call from your applications. The server is designed for quick testing and easy integration with your existing MCP clients.

How to install

git clone https://github.com/debba/turbosmtp-mcp-server.git
cd turbosmtp-mcp-server
npm install

Additional configuration and usage notes

Configure your TurboSMTP credentials in the code where the email sending logic is implemented (email-service.js). For production use you should store credentials in environment variables or a dedicated configuration file.

Start the server when you are ready to accept MCP requests. The runtime command is designed for local development and testing.

To validate behavior or perform a quick test, you can run the provided test script after you have the server running.

Security considerations

Keep TurboSMTP credentials out of your source control. Use environment variables or a secure secrets manager in production. Restrict access to the MCP endpoint to trusted services and consider enabling basic authentication or IP allowlists if your setup supports it.

Troubleshooting tips

If the server fails to start, ensure Node.js is installed (v14 or higher is recommended) and that there are no port or file permission issues. If emails fail to send, verify TurboSMTP credentials are correct and that network access to TurboSMTP is not blocked by firewall rules.

Available tools

sendEmail

Sends an email through TurboSMTP by invoking the MCP API exposed by the server.

checkStats

Retrieves or exposes sending statistics from TurboSMTP via the MCP interface.

testScript

Runs a quick validation of TurboSMTP features through the provided test harness.