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

Hermoso

Hermoso is an AI marketing agent and AI ad generator you run from your AI agent: a remote MCP server that researches the ads already winning in your market, makes image and video ads and organic posts in your brand, publ

OpenMark

OpenMark AI

OpenMark is a remote MCP server available at https://openmark.ai. Benchmark your own prompt on 100+ models with real API calls.

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

ZeroBeacon — 1000-Tool Collision-Proof Commerce Router

DavidFox998

ZeroBeacon.ai — Collision-proof commerce router for AI agents. 1000 MCP tools: commerce, trust, billing, sovereign ID + everyday tools. LIVE.

FARPY

mangomunchr

Verified distributed compute for humans, applications, and agents. Submit Blender, Octane, and video workloads, route them across qualified GPUs, track asynchronous execution, download finished artifacts, and verify FARP