Codecks MCP

这是一个用于Codecks任务管理的简单模型上下文协议（MCP）服务器。此MCP提供了对AI助手（如Cursor、Claude和其他兼容MCP工具）的任务卡片和卡片组的基本操作能力。

功能

• 管理卡片：创建、查看、更新和组织您的任务卡片
• 组织卡片组：创建新的卡片组并浏览现有的卡片组
• 智能筛选：根据状态和归档状态查找卡片

配置

Codecks MCP服务器通过MCP客户端配置文件（通常为~/.cursor/mcp.json或类似文件）进行配置。您需要设置以下环境变量：

必要配置

• CODECKS_AUTH_TOKEN - 您的Codecks认证令牌
• CODECKS_SUBDOMAIN - 您的Codecks子域

示例MCP配置

{
  "mcpServers": {
    "codecks": {
      "command": "node",
      "args": ["/path/to/codecks-mcp/dist/server.js"],
      "env": {
        "CODECKS_AUTH_TOKEN": "your_actual_auth_token",
        "CODECKS_SUBDOMAIN": "your_actual_subdomain"
      }
    }
  }
}

获取您的Codecks API令牌

1. 登录到您的Codecks账户
2. 打开浏览器的开发者工具（F12）
3. 转到网络标签
4. 对Codecks发起任何请求（刷新页面）
5. 查找指向https://api.codecks.io的请求
6. 在请求头中找到at cookie — 这就是您的API令牌
7. 复制该令牌并添加到您的MCP配置中

重要：此令牌允许完全访问您的账户。请妥善保管，不要与他人分享。

获取您的子域

1. 查看您的Codecks网址：https://[SUBDOMAIN].codecks.io
2. 子域部分即为所需内容
3. 例如，如果您的URL是https://myteam.codecks.io，则您的子域是myteam
4. 复制子域并添加到您的MCP配置中

可用工具

项目信息

• list-spaces - 列出项目中的所有可用空间

卡片管理

• get-card - 获取特定卡片的详细信息
• list-cards - 列出卡片组中的卡片，可选过滤
• create-card - 在卡片组中创建新卡片
• update-card - 更新卡片属性
• get-card-options - 获取创建卡片时可用的努力规模和优先级标签

卡片组管理

• list-decks - 列出账户中的所有卡片组
• create-deck - 创建新的卡片组

添加新工具

1. 在src/tools/中创建一个新的工具文件，扩展ToolGroup
2. 实现register()方法以注册工具
3. 在server.ts中导入并注册工具组
4. 使用Zod添加验证模式

📝 许可证

MIT许可证