Apisix MCP Bridge Example

APISIX MCP网桥插件示例

此存储库演示了如何使用APISIX MCP Bridge插件将模型上下文协议（MCP）服务器与APISIX集成。该设置包括构建一个具有Docker客户端功能的自定义APISIX Docker映像，并创建一个通过stdio通信的Bitbucket MCP服务器。

概述

MCP Bridge插件允许APISIX充当MCP服务器的代理，通过HTTP/SSE端点实现MCP客户端（如VS Code）和MCP服务器之间的无缝集成。

组件

• 自定义APISIX映像：通过Docker客户端增强了运行容器化MCP服务器的能力
• 比特桶MCP服务器：用于Atlassian Bitbucket集成的容器化MCP服务器
• MCP网桥插件：将HTTP/SSE桥接到stdio MCP通信的APISIX插件

先决条件

• Docker和Docker Compose
• 带有MCP扩展的VS代码（用于客户端测试）
• Atlassian Bitbucket凭据（用户名和应用程序密码）

配置

环境变量

编辑 .env 使用您的Bitbucket凭据：

ATLASSIAN_SITE_NAME="https://api.bitbucket.org"
ATLASSIAN_BITBUCKET_USERNAME="your_username"
ATLASSIAN_BITBUCKET_APP_PASSWORD="your_app_password"

建筑图片

构建APISIX映像

自定义APISIX映像包括用于运行容器化MCP服务器的Docker客户端：

docker-compose build apisix

构建Bitbucket MCP服务器映像

docker-compose build mcp-bitbucket

使用Docker Compose构建所有镜像

docker-compose build

运行服务器

启动所有服务

docker-compose up -d

这将开始：

• 端口80上的APISIX，带MCP网桥插件
• Whoami检测服务

验证服务

检查APISIX是否正在运行：

curl http://localhost/whoami

测试MCP网桥端点：

curl http://localhost/mcp-bitbucket/

VS代码MCP客户端配置

使用服务器发送事件（SSE）

配置VS Code MCP客户端以连接到APISIX MCP网桥端点：

1. 在VS代码中安装MCP扩展
2. 将以下配置添加到您的VS代码设置或MCP客户端配置中：

{
  "servers": {
    "mcp-bitbucket": {
      "type": "sse",
      "url": "http://localhost/mcp-bitbucket"
    }
  }
}

清理

停止并删除所有服务：

docker-compose down

删除构建的映像：

docker rmi arulrajnet/apisix:dev arulrajnet/mcp-bitbucket:v1.39.7

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

作者

Arul