Vibe Kanban Workspace

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

发展

测试设置

1. 测试主服务器：

   curl http://localhost:7842/api/health

1. API试验桥：

   curl -X POST "http://localhost:7843/claude/create-task" \
     -H "Content-Type: application/json" \
     -d '{"title": "Test Task", "description": "Test description"}'

1. 调试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

故障排除

常见问题

1. 服务未启动：

   pm2 delete all
   pm2 start ecosystem.config.js

1. 端口冲突：

检查端口7842、7843、7844是否可用：

   lsof -i :7842
   lsof -i :7843
   lsof -i :7844

1. Claude Desktop未连接：

检查MCP日志：

   tail -f ~/Library/Logs/Claude/mcp.log

团队指导方针

• 始终使用npm（不要使用yarn、pnpm或bun）
• 如有任何更改，请遵循公关流程
• 在推动更改之前进行本地测试
• 将package-lock.json保存在版本控制中
• 使用一致的编码标准

______________________________________________________________________

有关更多信息，请联系开发团队或查看项目文档。