MCP.so
Sign In

Moleculer MCP Bridge

@alvaroinckot

Repository

About Moleculer MCP Bridge

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

#moleculer#mcp#ai-tools

Config

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

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

Tools

No tools detected

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.

FAQ from Moleculer MCP Bridge

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.

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

Basic information

Category

Developer Tools

License

MIT

Transports

stdio

Author

alvaroinckot

More Developer Tools MCP servers

TaskerArmy Agent

TaskerArmy

Ask Claude or ChatGPT what Shopify theme optimization tasks are pending on your store, a remote MCP server for TaskerArmy Agent accounts.

AptiBuild AI — Career Intelligence

ParklandBuilds

AptiBuild AI — Career Intelligence MCP Server Structured career decision scaffolding for AI agents. Provides personality-conditioned business idea generation, official BLS OEWS wage data, FRED labor market signals, and

directree

coburn2716

directree MCP server — query the honest software directory from any AI assistant

LocalCan

LocalCan

Gives AI agents public URLs (tunnels) for localhost, live HTTP traffic inspection, snapshot publishing, and access control. Part of LocalCan, the ngrok alternative for Mac, Windows and Linux. Free plan.

82

Vibgrate MCP

Vibgrate

Query your team's drift, vulnerability, and migration data from any AI assistant. Vibgrate MCP connects Cursor, Claude, ChatGPT, Windsurf, or VS Code to Vibgrate Cloud: 51 tools for DriftScores, CVEs and EOL runtimes, up

3