<Markdown> - 项目简介 - 该仓库实现了一个 MCP 服务器,用于通过标准的 MCP(JSON-RPC) 协议向 LLM 客户端提供对 Azure Logic Apps 的上下文信息、可用工具和工作流定义的访问。服务器负责会话管理、能力声明以及对资源、工具和提示模板的统一访问入口。当前实现通过 Stdio 传输与客户端进行通信,便于在本地开发环境中和 Claude Copilot 等工具集成。
  • 主要功能点

    • 资源与数据访问:提供订阅、逻辑应用、工作流等资源的读取功能(如 list_subscriptions、list_logic_apps、list_workflows 等)。
    • 工具注册与执行:注册共计23个工具,覆盖订阅、Logic Apps 及工作流相关的数据查询、历史记录、触发器、运行细节等多种场景,允许 LLM 调用外部功能。
    • 工作流定义与猜测:获取 Consumption 与 Standard SKU 的工作流定义、触发器、版本、Swagger/OpenAPI、以及历史版本等信息。
    • 运行历史与调试:获取 run history、运行详情、动作及 IO(输入/输出)等调试信息。
    • 证书与身份认证:使用 Azure CLI 进行身份认证与令牌管理,自动刷新令牌,确保对 Azure REST API 的访问权限。
    • 多云支持:支持 Azure 公共云、政府云、中国云等环境,通过统一接口访问资源管理端点。
  • 安装步骤

    • 通过 npm 全局安装:
      • npm install -g github:laveeshb/logicapps-mcp
    • 或直接运行:
      • npx github:laveeshb/logicapps-mcp
    • 从源码构建(可选):
      • git clone https://github.com/laveeshb/logicapps-mcp.git
      • cd logicapps-mcp
      • npm install
      • npm run build
  • 服务器配置(MCP 客户端对 MCP 服务器的配置)

    • 说明:MCP 客户端需要配置一个服务器来连接并使用 MCP 服务。以下给出两种常见方式,任意一种都能让客户端与本 MCP 服务器建立连接。
    • 使用本地命令直接启动的配置(适用于本地命令行启动的 MCP 服务):
      • server name: logicapps
      • command: logicapps-mcp
      • args: []
      • 说明:如果你全局安装了该 MCP 服务器,推荐直接使用命令名 logicapps-mcp 启动,无需额外参数。
    • 使用 npx 启动的配置(适用于集成到 Claude Desktop 或其他工具的情况下):
      • server name: logicapps
      • command: npx
      • args: ["github:laveeshb/logicapps-mcp"]
      • 说明:通过 npx 直接从 GitHub 拉取并运行 MCP 服务器,适合临时试用或无全局安装环境。
  • 基本使用方法

    • 启动后,LLM 客户端即可通过 MCP JSON-RPC 调用访问 Tools 列表、读取资源、调用工具、获取工作流定义等能力。
    • 典型工作流包括:列出订阅与 Logic Apps、查询某个工作流的定义、获取运行历史、查看动作 IO、验证 API 连接等。
    • 若遇到错误,系统会返回带有错误码的标准化错误对象,便于在客户端进行一致的错误处理。
  • 备注

    • MCP 服务器核心实现基于 @modelcontextprotocol/sdk,提供 MCP 的服务器端能力、工具注册与工具调用分发等核心功能。
</Markdown>

信息

分类

网页与API