/ 目录 / 演练场 / mcp-agent-langchainjs
● 官方 Azure-Samples ⚡ 即开即用

mcp-agent-langchainjs

作者 Azure-Samples · Azure-Samples/mcp-agent-langchainjs

Azure 官方参考 — 一个无服务器 LangChain.js agent,使用 MCP 调用汉堡订餐工具 API,可通过 azd up 完全部署。

这是 Azure 官方示例应用,不是终端用户可用的 MCP。它展示了如何构建一个无服务器 LangChain.js agent,集成 MCP 以进行工具调用,部署到 Azure Static Web Apps + Functions + Cosmos DB。演示是一家汉堡餐厅 — 但这个模式适用于你在 Azure 上想要的任何工具调用 agent。

为什么要用

核心特性

实时演示

实际使用效果

agent-langchainjs.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "agent-langchainjs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-agent-langchainjs"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "agent-langchainjs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-agent-langchainjs"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "agent-langchainjs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-agent-langchainjs"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "agent-langchainjs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-agent-langchainjs"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "agent-langchainjs",
      "command": "npx",
      "args": [
        "-y",
        "mcp-agent-langchainjs"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "agent-langchainjs": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-agent-langchainjs"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add agent-langchainjs -- npx -y mcp-agent-langchainjs

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: mcp-agent-langchainjs

在 Azure 上使用 MCP 工具调用启动无服务器 agent

👤 构建 AI 功能的 Azure 开发者 ⏱ ~120 min advanced

何时使用: 你想在 Azure 上部署一个由 LLM 驱动的功能,并需要一个工作中的参考来 fork。

前置条件
  • Azure subscription — azure.microsoft.com — 免费层涵盖开发
  • Azure Developer CLIbrew install azd 或 Windows 安装程序
步骤
  1. Fork 并部署
    Fork Azure-Samples/mcp-agent-langchainjs 并引导我完成 azd up 部署到我的 Azure 订阅。✓ 已复制
    → 实时 Azure URL + Functions + Cosmos 已配置
  2. 替换演示工具
    用我的领域的自定义 MCP(如预约预订)替换汉堡订餐 MCP。向我展示连接方式。✓ 已复制
    → 代码差异 + 工作中的自定义工具
  3. 自定义 UI
    示例有一个聊天 UI;自定义品牌/颜色和欢迎消息。✓ 已复制
    → 样式化的应用

结果: 从经过验证的示例派生的可发货 Azure 托管 agent。

注意事项
  • 免费层 Azure OpenAI 配额低 — 在有容量的地区配置你自己的 OpenAI 资源;在环境变量中设置端点
  • 本地 Ollama 不能很好地处理复杂的工具调用 — 对于涉及多步骤工具调用的开发,使用云模型(GPT-4o-mini 等)

学习 MCP + LangChain.js 集成模式

👤 MCP 新手开发者 ⏱ ~60 min intermediate

何时使用: 你在评估 MCP,想看看它如何集成到 LangChain.js 生态中。

步骤
  1. 阅读代码
    总结这个 repo 如何将 MCP 连接到 LangChain.js agent。关键的集成点是什么?✓ 已复制
    → 架构说明
  2. 本地运行
    在 Codespaces 中运行它。演练汉堡订单流程。在日志中观察 MCP 工具调用。✓ 已复制
    → 工作中的本地运行 + 工具调用跟踪

结果: 在构建你自己的之前,获得对模式的实践理解。

组合

与其他 MCP 搭配,撬动十倍杠杆

agent-langchainjs + github

将示例 CI/CD 到你自己的 fork

Fork 该 repo,设置 GitHub Actions 在推送到 main 时进行 azd 部署。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
(参考应用 — 不是可调用的 MCP) N/A 这是你部署的示例应用,不是 Claude 调用的工具 N/A

成本与限制

运行它的成本

API 配额
Azure 按使用量计费
每次调用 Token 数
N/A — 你在构建应用,不是将其作为工具调用
费用
不同 — 免费层用于开发便宜;生产成本取决于流量
提示
尽早使用 Azure 成本警报。如果配置不当,Cosmos DB 可能很昂贵 — 在开发期间将其保持在无服务器层。

安全

权限、密钥、影响范围

凭据存储: Azure Key Vault + 托管身份(由 Bicep 模板设置)
数据出站: 完全在你的 Azure 订阅 + 选定的 LLM 端点内

故障排查

常见错误与修复

azd up fails: no capacity in region

OpenAI 容量因地区而异。尝试 eastus2、swedencentral 或 francecentral。

Functions cold-start slowness

生产使用高级计划;消费计划适合开发,但冷启动会延缓早期聊天。

MCP tool call not recognized

确认 LangChain.js 工具绑定使用了示例设置的 MCP 客户端。检查导入。

替代方案

mcp-agent-langchainjs 对比其他方案

替代方案何时用它替代权衡
Vercel AI SDK starter你更喜欢 Vercel / Next.js 托管不同的云;更小的示例
AWS Bedrock Agents + sample你在 AWS 上不同的堆栈;Bedrock agent 不是原生 MCP

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills