AgentKit 与 MCP 集成指南：打造企业级智能体应用

AgentKit 与 MCP 集成指南：打造企业级智能体应用

【免费下载链接】agent-kitAgentKit: Build multi-agent networks in TypeScript with deterministic routing and rich tooling via MCP.项目地址: https://gitcode.com/gh_mirrors/ag/agent-kit

AgentKit 是一款基于 TypeScript 的多智能体网络构建工具，通过 MCP（Model Context Protocol）协议实现确定性路由和丰富工具集成，帮助开发者轻松构建企业级智能体应用。本文将详细介绍如何将 MCP 与 AgentKit 集成，解锁数千种预构建工具，提升智能体的功能性和扩展性。

MCP 集成：连接智能体与工具生态的桥梁 🚀

MCP（Model Context Protocol）是一种标准化协议，允许智能体与外部工具服务进行通信。AgentKit 对 MCP 的原生支持，意味着开发者可以直接接入任何 MCP 服务器，无需重复开发基础工具功能。通过集成 Smithery 等 MCP 服务注册中心，可立即获取超过 2,000 种跨场景工具，涵盖数据库管理、API 交互、文件处理等多种能力。

AgentKit 的追踪架构展示了 MCP 工具在智能体网络中的数据流路径

快速上手：三种 MCP 服务器配置方式

AgentKit 支持Streamable HTTP、SSE和WebSocket三种传输协议，满足不同场景下的 MCP 服务器接入需求。以下是两种最常用的配置示例：

1. 自托管 MCP 服务器（WebSocket 协议）

import { createAgent } from "@inngest/agent-kit"; const neonAgent = createAgent({ name: "neon-agent", system: `你是帮助管理 Neon 数据库的智能助手`, mcpServers: [ { name: "neon", transport: { type: "ws", url: "ws://localhost:8080", }, }, ], });

2. Smithery 托管 MCP 服务器（HTTP 流协议）

import { createAgent } from "@inngest/agent-kit"; import { createSmitheryUrl } from "@smithery/sdk/config.js"; const smitheryUrl = createSmitheryUrl("https://server.smithery.ai/neon/ws", { neonApiKey: process.env.NEON_API_KEY, }); const neonAgent = createAgent({ name: "neon-agent", system: `你是帮助管理 Neon 数据库的智能助手`, mcpServers: [ { name: "neon", transport: { type: "streamable-http", url: neonServerUrl.toString(), }, }, ], });

AgentKit 智能体通过 MCP 集成 Neon 数据库工具的操作界面

核心配置参数详解

mcpServers是 AgentKit 连接 MCP 生态的核心配置项，其结构定义如下：

MCP.Server 配置对象

• name（必填）：服务器名称（如 "github"、"neon"），用于工具命名空间（工具名将自动前缀化，如 "neon-createBranch"）
• transport（必填）：传输协议配置，支持以下类型：

TransportSSE（服务器发送事件）

{ type: "sse", url: "https://mcp-server.com/events", eventSourceInit?: EventSourceInit, requestInit?: RequestInit }

TransportWebsocket（WebSocket）

{ type: "ws", url: "wss://mcp-server.com/ws", options?: WebSocketConstructorOptions }

企业级应用案例：Neon 数据库助手

通过 MCP 集成，AgentKit 可以快速构建专业领域的智能体应用。以 Neon 数据库助手为例，该智能体通过接入 Neon MCP 服务器，获得数据库管理的全功能工具集：

• 自动生成 SQL 查询
• 数据库性能监控
• 表结构管理
• 数据备份与恢复

基于 AgentKit + MCP 构建的 Neon 数据库管理智能体界面

完整示例代码可参考 examples/mcp-neon-agent 目录，该案例展示了从环境配置到工具调用的全流程实现。

部署与调试最佳实践

本地开发环境

1. 克隆仓库：git clone https://gitcode.com/gh_mirrors/ag/agent-kit
2. 安装依赖：pnpm install
3. 启动 MCP 测试服务器：pnpm run start:mcp
4. 运行示例：pnpm run dev:neon-agent

生产环境注意事项

• 使用streamable-http协议确保防火墙兼容性
• 配置请求超时和重试机制（通过requestInit参数）
• 监控 MCP 服务器健康状态（参考 docs/src/content/docs/concepts/deployment）

AgentKit 智能体与 MCP 服务器的部署同步监控界面

总结：释放智能体的真正潜力

通过 MCP 协议，AgentKit 打破了智能体与外部工具的集成壁垒，使开发者能够专注于业务逻辑而非工具实现。无论是自托管私有工具集，还是接入 Smithery 等公共工具市场，MCP 集成都为构建企业级智能体应用提供了标准化、可扩展的解决方案。

立即开始探索 packages/agent-kit/src/agent.ts 中的 MCP 实现源码，或查阅 docs/src/content/docs/advanced-patterns/mcp.mdx 获取完整文档，开启智能体应用开发的新篇章！

【免费下载链接】agent-kitAgentKit: Build multi-agent networks in TypeScript with deterministic routing and rich tooling via MCP.项目地址: https://gitcode.com/gh_mirrors/ag/agent-kit