AI导哈

看板工作区

一个综合性的看板项目工作区，支持Claude桌面集成，提供任务管理和实时通信功能。

  • by jikuya
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 jikuya/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

  2. API试验桥：

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

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

  2. 端口冲突： 检查端口7842、7843、7844是否可用：

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

  3. Claude Desktop未连接： 检查MCP日志：

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

团队指导方针

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

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

相关 MCP