逻辑应用MCP服务器

将Azure Logic Apps工作流转换为AI助手可通过模型上下文协议(MCP)使用的工具,适用于数据集成、业务自动化和自定义操作等场景。

  • by iLoveAgents
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 iLoveAgents/azure-logic-apps-mcp

使用说明

Azure 逻辑应用程序 MCP 服务器

通过模型上下文协议(MCP),将Azure逻辑应用工作流转换为AI助手可用的工具。

让人工智能代理来做这项工作

别把整个README文件都读完! 只需下载 AGENTS.md 翻译为中文是:“代理.md” 或者 “代理商文件.md”(具体翻译可能根据上下文有所调整,但“md”通常表示Markdown格式的文件)。在这里,“AGENTS”可能指的是代理或代理商的列表或说明,“.md”表示这是一个使用Markdown语言编写的文件 并将其交给一个人工智能代理。

然后说: “将我的Azure逻辑应用设置为MCP服务器”

代理会处理一切事宜:

  • 请求您的Azure资源
  • 配置MCP端点
  • 设置身份验证(开发或生产环境)
  • 创建你的第一个工具
  • 连接到VS Code或Claude

无依赖项。无脚本。只需一个AGENTS.md文件和一个人工智能代理。


还是想手动操作吗?请继续阅读。。。

手动设置(如您所愿)

先决条件

1. 在您的逻辑应用中启用MCP

# Set your values
export SUBSCRIPTION_ID="your-subscription-id"
export RESOURCE_GROUP="your-resource-group"
export LOGIC_APP_NAME="your-logic-app-name"

# Login and get token
az login
TOKEN=$(az account get-access-token --resource https://management.azure.com --query accessToken -o tsv)

# Get Kudu URL
KUDU_URL=$(az logicapp show \
  --name $LOGIC_APP_NAME \
  --resource-group $RESOURCE_GROUP \
  --query "enabledHostNames[?contains(@, 'scm')]|[0]" \
  -o tsv)

# Create host.json
cat > host.json <<'EOF'
{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Workflows",
    "version": "[1.*, 2.0.0)"
  },
  "extensions": {
    "workflow": {
      "McpServerEndpoints": {
        "enable": true,
        "authentication": {
          "type": "anonymous"
        }
      }
    }
  }
}
EOF

# Upload and restart
curl -X PUT "https://${KUDU_URL}/api/vfs/site/wwwroot/host.json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "If-Match: *" \
  --data-binary @host.json

az logicapp restart --name $LOGIC_APP_NAME --resource-group $RESOURCE_GROUP

等待30秒后重新启动。

2. 创建你的第一个工具

请看 AGENTS.md 翻译为中文是:“代理.md” 或者根据上下文,也可以翻译为“代理文件.md”(如果“AGENTS.md”是一个文件名,且“AGENTS”指的是“代理”的意思)。不过,通常在文件名中,“AGENTS.md”可能直接保留原样,或者根据具体语境翻译为更具体的名称。在这里,“代理”是比较通用的翻译,具体翻译可能需要根据文件内容或项目背景来确定 完整的工作流模板及上传说明。

3. 连接至AI助手

VS Code(推荐):

  1. 命令面板 → “MCP:添加服务器”
  2. 输入: https://your-logic-app-name.azurewebsites.net/api/mcp
  3. 您的工具会自动出现

Claude Desktop(桌面版)

{
  "mcpServers": {
    "logic-apps": {
      "url": "https://your-logic-app-name.azurewebsites.net/api/mcp",
      "transport": "streamable-http"
    }
  }
}

MCP检查员:

npx @modelcontextprotocol/inspector
# URL: https://your-logic-app-name.azurewebsites.net/api/mcp
# Transport: Streamable HTTP

创建工具

每种工具都是一个 无状态的 或者 有状态的 与……的工作流程:

  1. HTTP 请求触发器 (命名为“manual”)并带有JSON模式
  2. 业务逻辑 (任何工作流操作)
  3. HTTP 响应 (200 状态码,JSON 格式的响应体)

如需完整的流程模板和示例,请参阅 AGENTS.md 翻译为中文是:“代理列表/说明.md”(注:这里的“AGENTS”通常指的是代理或代表,“.md”是Markdown文件格式的后缀,表示这是一个Markdown格式的文件,可能包含代理的列表、说明或相关配置)。

用例

  • 数据集成查询数据库、API、Azure服务
  • 业务自动化触发工作流,发送通知
  • 数据转换转换格式,处理数据
  • 自定义操作执行特定的业务逻辑

生产安全

快速入门使用 匿名认证 用于开发/测试。

用于生产配置OAuth 2.0认证:

  • 行业标准的安全性
  • Azure AD 集成
  • 基于用户的访问控制
  • 基于作用域的权限

见 AGENTS.md 翻译为中文是:“代理.md”(注:这里的“.md”通常表示Markdown文件格式,但在中文语境下,我们通常直接保留“.md”以指明文件类型,不直接翻译)。所以,完整的翻译可以是“代理(Markdown文件)”。不过,根据上下文,有时也可能简化为“代理文件”来指代这类文件 包含完整的OAuth 2.0设置说明:

  • Azure AD 应用注册
  • 简易身份验证配置
  • VS Code 自动发现支持
  • 故障排除指南

注: VS Code 1.102+ 自动发现 OAuth 设置 - 只需添加服务器 URL 并登录!

故障排除

工具未出现:

  • 验证工作流程是否已纳入 <tool-name>/workflow.json
  • 检查 "kind": "Stateless" 被设置
  • 重启逻辑应用并等待30秒

认证错误:

  • 验证 authentication 在里面 McpServerEndpoints 在 host.json 中
  • 配置更改后重启逻辑应用

如需详细的故障排除和自动化部署信息,请参阅 AGENTS.md 翻译为中文是:“代理列表.md” 或 “代理说明文件.md”(具体翻译可能根据上下文有所调整,但“AGENTS”通常指的是“代理”的意思,“.md”是Markdown文件格式的扩展名)

资源

许可证

麻省理工学院(MIT)