Vibe Coding Buddy ^{🚀 MCP Edition}

A modern AI-powered coding assistant for your Vibe Coding

✨ 功能特性

• 🔄 MCP 协议：支持 stdio
• 🎨 现代 UI：PySide6 构建的响应式界面
• 🎤 语音交互：录音转文字

🚀 快速开始

1. 环境准备

确保安装了以下工具：

• Python 3.11+
• uv (推荐的包管理器)

2. 一键安装

# 安装 uv (如果尚未安装)
curl -LsSf https://astral.sh/uv/install.sh | sh

# 克隆项目
git clone <repo-url>
cd VC-Buddy-MCP

# 🎉 一键安装所有依赖（包括系统级依赖）
make install

3. 配置 MCP 服务器

Cursor

make mcp-cursor

按照提示，复制配置到对应的配置文件里。

🔧 Cursor IDE

• 官方 MCP 配置文档
• MCP 服务器配置指南

4. 设置 Cursor Rule

将以下内容放到 User Rules 里

Whenever you want to ask a question, always call the MCP `vc-buddy`.
Whenever you're about to complete a user request, call the MCP `vc-buddy` instead of simply ending the process. Keep calling MCP until the user's feedback is empty, then end the request.

5. 基本使用

5.1 GUI 界面使用

1. 文本输入: 在输入框中输入您的问题或需求
2. 语音输入: 点击麦克风按钮开始录音，支持实时转写
3. 发送消息: 点击发送按钮或使用快捷键 Ctrl+E
4. TODO 管理: 自动解析回复中的 TODO 项目，支持标记完成状态

5.2 快捷键

• Ctrl+E: 发送消息
• Ctrl+R: 开始/停止录音
• Ctrl+,: 打开设置

5.3 配置 API Key

首次使用需要配置 OpenAI API Key：

快捷键Ctrl+,，输入你的 Key，点击【测试链接】按钮。

🐛 故障排除

常见问题

1. 音频依赖安装失败 如果 make install 自动安装失败，请手动安装：

# macOS
brew install portaudio

# Ubuntu/Debian  
sudo apt-get install portaudio19-dev python3-dev

# CentOS/RHEL
sudo yum install portaudio-devel python3-devel

# Fedora
sudo dnf install portaudio-devel python3-devel

# Arch Linux
sudo pacman -S portaudio

然后重新运行：make install

2. OpenAI API 错误

• 检查 OPENAI_API_KEY 环境变量
• 确认 API 密钥有效且有余额
• 检查网络连接

3. GUI 无法启动

• 确认安装了 PySide6：uv add PySide6
• 检查显示环境（Linux 需要 X11 或 Wayland）
• 查看错误日志

4. MCP 服务器连接失败

• 确认服务器正在运行：curl http://localhost:8000/health
• 检查端口是否被占用
• 查看服务器日志

📄 许可证

本项目基于 MIT License 开源许可证发布。

---

享受与 Vibe Coding Buddy 的编程之旅！ 🎉