AI导哈

容器化MCP服务器管理工具

帮助用户在独立主机上快速部署和管理MCP服务器容器，避免开发环境资源争用。

  • by edumgui
  • Makefile
  • 本地部署
  • 更新于
在 GitHub 查看 edumgui/mcpservers-playground

使用说明

MCP游乐场-快速入门

项目动机

此项目旨在帮助您在与运行VS Code不同的主机上启动MCP服务器容器。这种分离确保了您的开发环境保持响应性，并避免了编码或构建时的资源争用。

旋转容器

为方便起见，您可以使用提供的 Makefile 管理容器：

  • make up --启动所有容器
  • make down --停止所有容器
  • make logs --跟踪所有容器的日志
  • make logs SERVICE=<service-name> --跟踪单个容器的日志（例如。， make logs SERVICE=caddy)
  • make status --显示容器状态
  • make restart --重新启动所有容器

环境变量

某些容器需要环境变量才能正确启动。例如，GitHub MCP服务器在您的 .env 文件：

GITHUB_PERSONAL_ACCESS_TOKEN=your_github_token_here
GITHUB_TOOLSETS=issues,pull_requests,search,commits,repository
GITHUB_READ_ONLY=1

您可以复制 .env.original 向 .env 并填写你的价值观。这些变量在 podman-compose.yml 以便于配置和更新。

YAML可重用块

这 podman-compose.yml 为可重用的容器配置块使用YAML锚点和别名。这减少了重复，使维护更容易。

必需步骤：主机名解析

您必须向您的 /etc/hosts 客户端计算机上的文件：

<IP_OF_MCP_HOST> mcpservers-playground

替换 <IP_OF_MCP_HOST> 其中包含运行容器的主机的实际IP地址。这确保了请求 http://mcpservers-playground:8888 正确解决。

  1. 请确保您已安装Podman和Podman compose。

  2. 在项目根目录中，运行：

    podman-compose up -d

  3. 要停止所有容器：

    podman-compose down

服务

故障排除

  • 如果容器无法启动，请检查日志：

    podman-compose logs <service-name>

  • 确保端口未被其他进程阻塞。

相关 MCP