Mcpservers Playground

MCP游乐场-快速入门

项目动机

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

旋转容器

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

• make up --启动所有容器
• make down --停止所有容器
• make logs --跟踪所有容器的日志
• make logs SERVICE= --跟踪单个容器的日志（例如。， 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 客户端计算机上的文件：

 mcpservers-playground

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

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

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

   podman-compose up -d

1. 要停止所有容器：

   podman-compose down

服务

• 球童服务器
• Context7 MCP服务器
• 顺序思维MCP服务器
• Terraform MCP服务器

故障排除

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

  podman-compose logs 

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