Moleculer MCP Bridge

@alvaroinckot

Repository

Basic information

About Moleculer MCP Bridge

A Model Context Protocol (MCP) server that exposes Moleculer.js actions as AI tools.

#moleculer#mcp #ai-tools

Moleculer MCP Bridge config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "moleculer-mcp": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "moleculer-mcp",
        "."
      ]
    }
  }
}

Moleculer MCP Bridge tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Moleculer MCP Bridge?

Moleculer MCP Bridge acts as a bridge between the Model Context Protocol (MCP) and Moleculer.js microservices. It automatically exposes all your Moleculer service actions as MCP tools, enabling AI agents to seamlessly interact with your Moleculer services.

How to use Moleculer MCP Bridge?

Install globally with npm install -g moleculer-mcp. Start the bridge using moleculer-mcp start optionally pointing to a Moleculer config file (-m flag) or a custom bridge configuration JSON. Connect any MCP-compatible AI client (e.g., Claude Desktop) to http://localhost:3000/ or http://localhost:3000/v1/mcp.

Key features of Moleculer MCP Bridge

Automatically exposes Moleculer actions as MCP tools.
Pattern-based allow/block lists with wildcard support.
Custom tool definitions with parameter overrides.
Configurable via JSON file or environment variables.
Deployable via Docker with volume mounts.
Works with any MCP-compatible AI client.

Use cases of Moleculer MCP Bridge

Let AI agents call existing Moleculer microservice actions directly.
Expose a curated subset of actions with controlled parameters.
Bridge between AI assistants and microservice backends.
Enable automated workflows via MCP clients like Claude Desktop.

Frequently asked questions

What is the default port for the MCP server?

The default port is 3000.

How can I limit which Moleculer actions are exposed?

Use the `allow` array in your configuration JSON with wildcard patterns such as `"users.*"` to filter actions.

How do I run Moleculer MCP Bridge with Docker?

Build the image with `docker build -t moleculer-mcp .` and run with `docker run -p 3000:3000 moleculer-mcp`. Configuration files can be mounted as volumes.

Can I configure the bridge via environment variables?

Yes, set the `MCP_BRIDGE_SETTINGS` environment variable to a JSON string containing your configuration.

What Node.js version is required for development?

Development is configured with Node.js 22.19.0 (via mise). Production Docker images use the latest Node.js LTS.

Comments

More Developer Tools MCP servers

ShipMyForm

ShipMyForm.com

Form backend for static sites. Create form endpoints, get paste-ready markup for HTML, React, Vue, Svelte and Astro, and read submission stats — straight from your agent. Submissions are spam-filtered, stored, and routed

Perfex CRM

themesic

Turn Perfex CRM into an AI-ready workspace. This MCP server exposes your full REST API to Claude, ChatGPT and any AI agent, so leads, invoices and tasks are one prompt away.

Eddyter AI Rich Text Editor MCP

EddyterAI

Set up and manage the Eddyter AI rich text editor by talking to your AI agent — for Claude, Cursor, Codex and other MCP tools. A Model Context Protocol server that lets AI tools add Eddyter to a React, Next.js, Vite or R

Casefile

azimov777

One case file per task — shared by every session, agent and person that touches it. Self-hosted MCP server and live board. MIT.

GripForge

gripforgeai

The tools your AI needs to make your games. Turn prompts into production-ready game assets — animated characters with their weapons attached, seamless textures, terrain, VFX, HUDs — and playable game kits Unity, Godot, U