香港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协议：