Vibe看板工作区
与Claude Desktop集成的Vibe看板项目综合工作区。
程序包管理器
这个项目使用npm作为标准包管理器。
请使用以下命令：
# Install dependencies
npm install
# Start the application
npm start
# Development
npm run dev不要使用纱线、pnpm或发髻 -坚持使用npm以保持整个团队的一致性。
服务
主要服务
- vibe看板 （端口7842）： 锈基 看板应用服务器
- vibe桥 （端口7843）：用于Claude Desktop集成的桥接服务
- WebSocket服务器 （端口7844）：实时通信
流程管理
服务由PM2管理。 主服务器现在使用Rust二进制文件 vibe-kanban:
# Start all services (recommended)
./start.sh
# Stop all services
./stop.sh
# Manual PM2 commands
pm2 start ecosystem.config.js
pm2 list
pm2 logs
pm2 restart all快速启动脚本
./start.sh：使用正确的配置启动所有服务./stop.sh：优雅地停止所有服务
Rust二进制配置
主服务器已从Node.js迁移到基于Rust的实现：
- 二进制位置:
/Users/jikuya/.volta/tools/image/node/20.19.1/bin/vibe-kanban - 端口：7842（通过配置
PORT环境变量） - PM2配置：更新于
ecosystem.config.js - 自动启动：PM2配置已保存以供系统启动
Rust实现的好处：
- 演出：比Node.js版本快得多
- 存储器效率：更低的内存占用
- 可靠性：更好的错误处理和稳定性
- 并发：具有卓越性能的原生async/await
Claude桌面集成
MCP服务器配置
该项目包括一个用于Claude Desktop集成的MCP（模型上下文协议）服务器。
配置在 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"vibe-kanban": {
"command": "node",
"args": [
"/Users/jikuya/vibe-kanban-workspace/mcp-server/index.js"
],
"env": {
"VIBE_KANBAN_PORT": "7842",
"VIBE_WORKSPACE": "/Users/jikuya/vibe-workspace"
}
}
}
}可用工具
create_task：创建新任务list_tasks：列出现有任务update_task：更新任务状态execute_task：执行任务
API终点
桥梁API（端口7843）
POST /claude/create-task-创建新任务GET /claude/tasks-列出任务PATCH /claude/update-task/:id-更新任务POST /claude/execute-task/:id-执行任务
主要API（端口7842）
GET /api/health-健康检查POST /api/tasks-创建任务GET /api/tasks-列出任务PATCH /api/tasks/:id-更新任务
环境变量
复制 .env.example 向 .env 并配置：
# Core settings
VIBE_PROJECT_ID=a2695f64-0f53-43ce-a90b-e7897a59fbbc
VIBE_PORT=7842
BRIDGE_PORT=7843
WEBSOCKET_PORT=7844
# Workspace paths
VIBE_WORKSPACE=/Users/jikuya/Repositories/jikuya/vibe-workspace
WORKSPACE_PATH=/Users/jikuya/Repositories/jikuya/vibe-workspace
# Environment
NODE_ENV=production
AGENT_MODE=local发展
测试设置
- 测试主服务器：
curl http://localhost:7842/api/health- API试验桥：
curl -X POST "http://localhost:7843/claude/create-task" \
-H "Content-Type: application/json" \
-d '{"title": "Test Task", "description": "Test description"}'- 调试Claude桌面集成：
./debug-claude-desktop.sh项目结构
vibe-kanban-workspace/
├── README.md # This file
├── package.json # npm dependencies
├── ecosystem.config.js # PM2 configuration
├── .env # Environment variables
├── scripts/
│ └── bridge.js # Bridge service
├── mcp-server/
│ └── index.js # MCP server for Claude Desktop
├── logs/ # Application logs
└── config/ # Configuration files故障排除
常见问题
- 服务未启动：
pm2 delete all
pm2 start ecosystem.config.js- 端口冲突：
检查端口7842、7843、7844是否可用：
lsof -i :7842
lsof -i :7843
lsof -i :7844- Claude Desktop未连接：
检查MCP日志：
tail -f ~/Library/Logs/Claude/mcp.log团队指导方针
- 始终使用npm（不要使用yarn、pnpm或bun）
- 如有任何更改，请遵循公关流程
- 在推动更改之前进行本地测试
- 将package-lock.json保存在版本控制中
- 使用一致的编码标准
______________________________________________________________________
有关更多信息，请联系开发团队或查看项目文档。