Moleculer MCP Bridge

Name: Moleculer MCP Bridge
Author: alvaroinckot

@alvaroinckot

リポジトリ

Moleculer MCP Bridge について

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

#moleculer #mcp #ai-tools

基本情報

カテゴリ

開発者ツール

ライセンス

MIT

ランタイム

node

トランスポート

stdio

公開者

alvaroinckot

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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.