AI导哈

任务卡片管理协议

Codecks MCP是一个简单的模型上下文协议服务器，提供卡片和牌组管理功能，适用于AI助手和任务管理工具。

  • by Simokod
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 Simokod/codecks-mcp

使用说明

编解码器MCP

用于Codecks任务管理的简单模型上下文协议（MCP）服务器。此MCP为Cursor、Claude和其他MCP兼容工具等AI助手提供了基本的卡和牌组操作功能。

特性

  • 管理卡片：创建、查看、更新和组织任务卡
  • 整理甲板：创建新甲板并浏览现有甲板
  • 智能过滤：按状态查找卡片并存档状态

配置

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 URL： https://[SUBDOMAIN].codecks.io
  2. 子域部分正是您所需要的
  3. 例如，如果您的URL是 https://myteam.codecks.io，您的子域是 myteam
  4. 复制子域并将其添加到MCP配置中

可用工具

项目信息

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

卡片管理

  • get-card -获取特定卡的详细信息
  • list-cards -在带有可选过滤功能的牌组中列出卡片
  • list-hand-cards -列出当前在经过身份验证的用户手中的卡片
  • create-card -在牌组中创建新卡
  • update-card -更新卡属性
  • get-card-options -获取创建卡片的可用工作量和优先级标签

甲板管理

  • list-decks -列出账户中的所有牌组
  • create-deck -创建新甲板

添加新工具

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

📝 许可证

MIT许可证

相关 MCP