MCP桥接插件

APISIX MCP桥接插件用于将模型上下文协议(MCP)服务器与APISIX集成,通过HTTP/SSE端点实现MCP客户端(如VS Code)与MCP服务器之间的无缝通信。

  • by arulrajnet
  • Dockerfile
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 arulrajnet/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