AI导哈

AI网关工具

Kong MCP网关示例展示了如何使用Kong Gateway与模型上下文协议（MCP）将API和服务暴露为AI可访问的工具，支持REST API到MCP工具的转换和动态工具发现。

  • by hguerrero
  • HTML
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 hguerrero/kong-mcp-gateway-examples

使用说明

香港MCP网关示例

此存储库演示了如何使用Kong Gateway和模型上下文协议（MCP）将API和服务作为AI可访问的工具公开。它展示了MCP与Kong Gateway集成的两种主要模式。

🎯 概述

模型上下文协议（MCP）是一个开放标准，使AI应用程序能够安全地连接到外部数据源和工具。此存储库提供了使用Kong Gateway的实际示例 ai-mcp-proxy 插件：

  • 将REST API转换为MCP工具 -将现有的HTTP API转换为AI代理可以发现和使用的MCP兼容工具
  • 代理MCP注册表 -连接到MCP服务器注册表以进行动态工具发现
  • 构建AI代理 -通过Kong Gateway创建利用MCP工具的智能代理

📁 仓库结构

kong-mcp-gateway-examples/
├── mcp-proxy/          # MCP proxy pattern examples
│   ├── kong-config/    # Kong Gateway configuration
│   └── openapi.yaml    # Chuck Norris API OpenAPI specification
├── mcp-registry/       # MCP registry integration examples
│   ├── kong-config/    # Kong Gateway configuration
│   └── volcano-agent/  # AI agent using Volcano SDK
│       ├── src/        # TypeScript source files
│       │   ├── agent.ts      # CLI implementation
│       │   └── server.ts     # Web UI server
│       ├── public/     # Web UI frontend (dark theme)
│       └── package.json
└── example/            # Basic Kong AI Gateway usage

🚀 快速开始

先决条件

  • Docker和Docker Compose
  • Node.js 18+（用于火山代理）
  • Python 3.8+（基本示例）
  • OpenAI API密钥

环境设置

设置您的OpenAI API密钥：

export OPENAI_API_KEY="your-api-key-here"

📚 例子

1.MCP代理模式(mcp-proxy/)

演示如何使用Kong Gateway的将REST API作为MCP工具公开 ai-mcp-proxy 插件在 转换监听器 模式。

使用案例：

  • 将现有的REST API转换为MCP工具
  • 向人工智能代理公开第三方API（如Chuck Norris API）
  • 代理远程MCP服务器

主要特点：

  • 自动REST到MCP转换
  • 工具发现和调用
  • 请求/响应日志记录
  • 现有MCP服务器的直通模式

看 mcp代理/README.md 了解详细的设置和使用方法。

2.MCP注册表模式(mcp-registry/)

演示如何与MCP服务器注册表集成以进行动态工具发现，并包含基于Volcano SDK的AI代理。

使用案例：

  • 连接到MCP服务器注册表
  • 动态工具发现
  • 构建搜索和使用MCP工具的AI代理
  • 通过身份验证实现安全的注册表访问

组件：

  • 注册表访问的Kong配置
  • Volcano Agent-使用Volcano SDK的TypeScript AI代理
    • 命令行接口命令模式：用于快速脚本编写的命令行界面
    • Web UI模式：以深色为主题的网页界面，带有香港2026品牌（霓虹石灰绿）
  • 与Konnect集成，实现安全凭证管理

看 mcp注册表/README.md 了解详细的设置和使用方法。

3.基本示例(example/)

简单的Python示例演示了使用OpenAI客户端使用Kong AI Gateway。

看 example/README.md 有关设置说明。

🔧 Kong AI MCP代理插件

这 ai-mcp-proxy 插件是实现MCP集成的核心组件。它支持两种模式：

转换监听器模式

通过在Kong配置中定义工具架构，将REST API端点转换为MCP工具。

plugins:
- name: ai-mcp-proxy
  config:
    mode: conversion-listener
    tools:
    - description: Retrieve a random joke
      method: GET
      path: /api/jokes/random

直通侦听器模式

无需修改即可将请求代理到现有的MCP服务器。

plugins:
- name: ai-mcp-proxy
  config:
    mode: passthrough-listener

🏗️ 建筑

AI Agent (OpenAI/Anthropic)
    ↓
Kong Gateway (ai-mcp-proxy plugin)
    ↓
├── REST APIs (converted to MCP tools)
├── MCP Servers (proxied)
└── MCP Registries (for tool discovery)

📖 了解更多

🤝 贡献

欢迎投稿！请随时提交问题或拉取请求。

📄 许可证

本项目按原样提供，用于演示目的。

🆘 支持

如有疑问或问题：

相关 MCP