项目简介

Moleculer MCP Bridge 是一个桥接 Moleculer.js 微服务框架与 Model Context Protocol (MCP) 的应用后端。它使得 Moleculer 微服务网络中的服务动作能够以标准化的 MCP 工具形式被大型语言模型 (LLM) 客户端调用和使用，从而将后端业务能力开放给 AI 智能体。

主要功能点

• 自动暴露服务动作: 自动检测 Moleculer 微服务中的动作，并将其转换为符合 MCP 标准的工具。
• 可配置的访问控制: 支持通过配置来过滤和允许特定的服务或动作被暴露为 MCP 工具。
• 自定义工具定义: 允许定义自定义的 MCP 工具，映射到特定的 Moleculer 动作，并支持参数覆写。
• HTTP 传输协议: 通过 HTTP POST 请求处理 MCP 客户端的 JSON-RPC 调用。
• 与 Moleculer 集成: 能够加载现有的 Moleculer 配置文件，连接到现有微服务网络。
• CLI 工具: 提供命令行接口进行启动、配置验证和动作列表查看。

安装步骤

确保您已安装 Node.js。然后通过 npm 全局安装 moleculer-mcp：

npm install -g moleculer-mcp

服务器配置 (供 MCP 客户端连接)

MCP 客户端（如 Claude Desktop）需要配置 MCP 服务器的连接信息。对于通过 moleculer-mcp 启动的服务器，您通常需要配置以下信息：

• 服务器名称: 'Moleculer-MCP' (这是默认名称，如果服务器配置中修改了名称，请使用实际名称)
• 协议/传输方式: 'HTTP' (或 'Streamable HTTP')
• 端点 URL: 'http://localhost:3000/' 或 'http://localhost:3000/v1/mcp' (这是默认端口和路径，如果服务器配置中修改了端口，请使用实际端口)

请在您的 MCP 客户端配置界面填写相应的服务器连接信息。客户端不需要配置服务器启动命令 ('command') 或启动参数 ('args')，这些是服务器自身的运行配置。

基本使用方法

1. 启动默认配置的服务器:

   这将启动一个连接到本地 NATS 并暴露所有 Moleculer 动作的 MCP 服务器（需要本地运行 Moleculer broker 并注册服务）：

   moleculer-mcp start
   

   服务器将默认在 'http://localhost:3000/' 监听 MCP 请求。

2. 使用自定义配置文件启动:

   创建一个 'config.json' 文件来配置允许暴露的动作、端口等（示例见项目 README），然后使用该文件启动：

   moleculer-mcp start config.json
   

3. 结合 Moleculer 配置文件启动:

   如果您的 Moleculer 项目有自己的 'moleculer.config.js'，您可以在启动 MCP Bridge 时指定它：

   moleculer-mcp start -m ./moleculer.config.js
   

服务器启动后，您即可在支持 MCP 协议的 LLM 客户端中配置连接信息，让 AI 调用您暴露的微服务动作。