项目简介 Vibes是一个创新的项目，旨在通过分布式Model Context Protocol (MCP) 服务器，将Anthropic Claude桌面版转化为一个功能强大的对话式开发环境。它允许LLM（如Claude）通过调用特定功能的MCP服务器来执行Shell命令、进行GUI自动化、管理时间、与GitHub、Azure、Terraform和IT Glue等服务进行交互。Vibes的核心理念是“提问 → 构建 → 理解 → 改进 → 创造”，帮助用户通过对话式交互来构建和理解软件。

主要功能点 Vibes由多个专门的MCP服务器组成，每个服务器提供特定的能力：

mcp-vibes-server: 提供安全的Shell命令行访问和容器管理功能，允许AI执行系统命令。
mcp-vibesbox-server: 实现统一的Shell和VNC GUI自动化，AI可以直接操作桌面环境，如点击、拖拽、输入文本和截屏，实现可视化交互。
mcp-time-server: 提供时间及日期功能，包括获取当前时间、Unix时间戳、格式化时间以及列出支持的时区。
mcp-itglue-server: 集成IT Glue API，允许AI管理组织、配置、灵活资产、密码、文档和联系人等IT资产。
其他MCP服务器: 还包括用于持久化对话记忆、知识管理、GitHub仓库集成、Azure云操作、Terraform基础设施即代码管理以及无头浏览器自动化等功能的服务器。

安装步骤

安装必要软件: 确保您的系统已安装Docker Desktop、Claude Desktop和Git。

克隆仓库: 打开终端，执行以下命令克隆Vibes仓库并创建Docker网络：

git clone https://github.com/jonhill90/vibes.git
cd vibes
docker network create vibes-network

启动MCP服务器: 进入'mcp/mcp-vibes-server'目录，启动核心Vibes MCP服务器。根据需要，您可以启动其他子目录下的MCP服务器（例如'mcp/mcp-time-server'或'mcp/mcp-itglue-server'），通常每个服务器都有一个'docker-compose.yml'文件或可以直接运行'server.py'脚本。

cd mcp/mcp-vibes-server
docker-compose up -d
# 示例：启动时间服务器
# cd ../mcp-time-server
# docker-compose up -d
# 示例：启动Vibesbox服务器
# cd ../mcp-vibesbox-server
# docker-compose up -d
# 示例：启动IT Glue服务器
# cd ../mcp-itglue-server
# docker-compose up -d
cd ../.. # 返回项目根目录

配置Claude Desktop MCP设置: 根据您的操作系统，编辑Claude Desktop的配置文件。

macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%\Claude\claude_desktop_config.json'

在'mcpServers'部分添加或修改以下JSON配置，以连接到MCP服务器。请根据您启动的具体服务器，添加对应的配置。以下是一些常用服务器的示例配置（请注意：'command'和'args'是MCP客户端用于启动和连接到MCP服务器的关键信息，不需要代码，用户只需了解其含义）：

Vibes核心服务器 (mcp-vibes-server):

{
  "mcpServers": {
    "vibes": {
      "command": "docker",
      "args": ["exec", "-i", "mcp-vibes-server", "python3", "/workspace/server.py"]
    }
  }
}

'vibes' 是MCP服务器的唯一名称。'command' 指定了启动服务器的程序是 'docker'。'args' 是传递给 'docker' 命令的参数，指示它在名为 'mcp-vibes-server' 的运行中容器内执行 '/workspace/server.py' Python脚本。

时间服务器 (mcp-time-server):

{
  "mcpServers": {
    "time": {
      "command": "docker",
      "args": ["exec", "-i", "mcp-time-server", "python3", "/workspace/server.py"]
    }
  }
}

'time' 是MCP服务器的唯一名称。'command' 和 'args' 指示在名为 'mcp-time-server' 的容器内执行 '/workspace/server.py'。

Vibesbox GUI自动化服务器 (mcp-vibesbox-server):

{
  "mcpServers": {
    "vibesbox": {
      "command": "docker",
      "args": ["exec", "-i", "mcp-vibesbox-server", "python3", "/workspace/server.py"]
    }
  }
}

'vibesbox' 是MCP服务器的唯一名称。'command' 和 'args' 指示在名为 'mcp-vibesbox-server' 的容器内执行 '/workspace/server.py'。

IT Glue集成服务器 (mcp-itglue-server):

{
  "mcpServers": {
    "itglue": {
      "command": "docker",
      "args": ["exec", "-i", "mcp-itglue-server", "python3", "/workspace/server.py"]
    }
  }
}

'itglue' 是MCP服务器的唯一名称。'command' 和 'args' 指示在名为 'mcp-itglue-server' 的容器内执行 '/workspace/server.py'。

请将上述JSON片段合并到您的 'claude_desktop_config.json' 文件中。

重启Claude Desktop: 更新配置后，务必重启Claude Desktop应用程序，以便加载新的MCP服务器设置。

基本使用方法 配置并重启Claude Desktop后，AI（如Claude）将能够通过你所定义的MCP服务器名称（例如'vibes'、'time'、'vibesbox'、'itglue'）来访问这些服务器提供的工具。在与Claude的对话中，你可以直接指示它执行这些服务器的能力：

执行Shell命令: 告诉Claude“请使用'vibes'服务器运行一个Linux命令，例如'ls -l'”。
获取当前时间: 告诉Claude“'time'服务器，现在是什么时间？”或“请使用'time'服务器获取东京的当前时间。”
GUI自动化: 告诉Claude“使用'vibesbox'服务器点击屏幕上的某个坐标（例如x=100, y=200）”或“请'vibesbox'服务器截取一个屏幕截图。”
IT Glue数据查询: 告诉Claude“'itglue'服务器，列出所有组织”或“获取ID为123的配置项详情。”

AI会根据你的指令调用相应的MCP工具，并返回结果。

关键词

信息