看板应用

Wasiban

使用Next.js、Ant Design和Prisma构建的看板应用程序。

特性

• 具有拖放重新排序功能的板、列和卡
• 卡片标签、截止日期、优先级和降价描述
• 每张卡的状态更新和线程注释
• 搜索和优先级过滤
• 暗模式支持
• 用于AI代理集成的MCP服务器

本地运行（npm+SQLite）

先决条件

• Node.js v20.19+、v22.12+、v24.0+（prisma要求）
• npm

设置

1. 安装依赖项

   复制

   npm install
   

2. 配置环境

   创建一个 .env 项目根目录中的文件：

   复制

   DATABASE_URL="file:./dev.db"
   

3. 运行迁移

   复制

   npx prisma migrate dev
   

   这将应用迁移并自动生成Prisma客户端。

4. 为数据库添加种子 （可选--创建示例板）

   复制

   npm run db:seed
   

5. 启动开发服务器

   复制

   npm run dev
   

   该应用程序将在 http://localhost:3003.

有用的脚本

使用Docker（或Podman）运行

注： 如果您位于公司代理/防火墙之后，则可能需要处理TLS证书验证。有两个选项可供选择：

选项A——禁用TLS验证（仅限开发，不适用于生产）

添加 --tls-verify=false 旗帜（波德曼）或 --insecure 标志（Docker）绕过注册表TLS。您还必须设置 NODE_TLS_REJECT_UNAUTHORIZED=0 在 build Docker的一个阶段，这样Node.js（Prisma、npm）在构建过程中进行网络调用时就可以跳过TLS验证：

复制

# In the build stage, before the prisma commands:
ENV NODE_TLS_REJECT_UNAUTHORIZED=0
RUN npx prisma generate
RUN npx prisma migrate deploy
RUN npm run build

选项B——信任您的企业CA证书（推荐）

一种更安全的方法是将您的公司CA证书文件复制到容器中，并在任何网络调用之前的构建阶段信任它：

复制

# In the build stage, before the prisma commands:
COPY corporate-ca.pem /usr/local/share/ca-certificates/corporate-ca.crt
RUN update-ca-certificates
RUN npx prisma generate
RUN npx prisma migrate deploy
RUN npm run build

Podman用户： Podman与Docker CLI兼容。更换每个 docker 命令如下（和 医生.md)与 podman其他一切——标志、卷语法、图像名称——都保持不变。命名卷通过以下方式进行管理 podman volume 而不是 docker volume.

看 医生.md 了解完整的Docker说明。快速启动：

1. 塑造形象

   复制

   docker build -t wasiban .
   

2. 运行容器

   复制

   docker run -p 3003:3003 -v wasiban-data:/app/data wasiban
   

   该应用程序将在 http://localhost:3003.

   容器在首次启动时自动运行迁移并为数据库添加种子。这 -v wasiban-data:/app/data 标志会在重新启动时保留SQLite数据库。

代码更改后的重建

docker build -t wasiban . && docker run -p 3003:3003 -v wasiban-data:/app/data wasiban

MCP服务器

Wasiban揭露了一个 模型上下文协议 服务器，这样AI代理就可以以编程方式读取和管理电路板。看 MCP.md 获取完整文档。

手动运行服务器

npm run mcp

通过Claude CLI连接

有两种连接方式-- 本地 （直接读取源文件，使用本地 dev.db)或 码头工人 （使用构建的映像及其持久卷）。

选项1——当地（建议开发）

claude mcp add --transport stdio --scope user wasiban-local \
  -- /path/to/wasiban/scripts/mcp.sh

替换 /path/to/wasiban 带有克隆仓库的绝对路径。

选项2——Docker（或Podman）

claude mcp add --transport stdio --scope user wasiban-docker \
  -- docker run -i -v wasiban-data:/app/data wasiban node ./node_modules/.bin/tsx src/mcp/server.ts

Podman用户更换 docker 随着 podman:

claude mcp add --transport stdio --scope user wasiban-docker \
  -- podman run -i -v wasiban-data:/app/data wasiban node ./node_modules/.bin/tsx src/mcp/server.ts

如果自上次构建以来进行了代码更改，请运行 docker build -t wasiban . （或 podman build -t wasiban .)首先。

可用工具

可用资源

优先级

卡片支持四个优先级，并在看板上显示自定义图标：

优先级可以在卡片细节抽屉中设置，并从板工具栏或通过API/MCP服务器进行过滤。

您还可以直接调用REST端点：

GET /api/cards?priority=high&boardId=<board-id>
GET /api/cards?priority=highest&columnId=<column-id>

环境变量

技术栈

• 框架 — Next.js
• 用户界面 — Ant Design
• 数据库 --SQLite通过 libsql
• 对象关系映射 — 棱镜
• 拖放 — dnd套件
• 主控程序 — @模型上下文协议/sdk