内容
# Ctrl 项目管理
一款用于管理项目和任务的深色主题 GTK4 看板，内置 MCP（模型上下文协议）服务器以支持 AI 代理集成。
## 功能
- **看板** — 跨列拖拽任务
- **项目管理** — 创建、切换和组织多个项目
- **月份筛选** — 按月份查看任务，导航简便
- **AI 代理访问** — 内置 MCP 服务器允许 AI 工具（例如 OpenCode、Claude Desktop）读取和修改您的看板
## 使用
### 图形用户界面
```bash
ctrl-project-management
```
### MCP 服务器（用于 AI 代理）
```bash
ctrl-project-management mcp
```
测试它：
```bash
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | ctrl-project-management mcp
```
## 安装
### 从发布版本
```bash
# tar.gz
tar xzf ctrl-project-management-v0.1.0-linux-x86_64.tar.gz
./install.sh # 用户安装（~/.local/bin）
sudo ./install.sh --system # 系统范围安装（/usr/local/bin）
# deb
sudo dpkg -i ctrl-project-management_0.1.0_amd64.deb
```
### 从源代码
```bash
sudo apt install libgtk-4-dev
cargo build --release
./scripts/install.sh
```
## 构建发布版本
```bash
./scripts/release.sh 0.1.0
```
在项目根目录生成 `.tar.gz` 和 `.deb`。
## 代理配置
在 OpenCode 或 Claude Desktop 上注册：
```json
{
"mcpServers": {
"kanban": {
"command": "ctrl-project-management",
"args": ["mcp"]
}
}
}
```
