项目简介

CowGnition (奶牛认知) 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在连接 Remember The Milk (RTM) 任务管理服务与支持 MCP 协议的 LLM 客户端，例如 Claude Desktop。通过 CowGnition，用户可以使用自然语言与 AI 助手对话，从而便捷地查看、创建和管理 RTM 中的任务和列表。

主要功能点

• 查看任务和列表：允许 LLM 客户端获取用户在 Remember The Milk 中的任务列表、特定列表的任务以及今日待办任务等信息。
• 创建和更新任务：支持通过 LLM 客户端在 Remember The Milk 中创建新任务、修改任务属性（如截止日期、优先级、标签等）。
• 完成任务：允许 LLM 客户端将 Remember The Milk 中的任务标记为已完成。
• 管理截止日期：支持使用自然语言设置和修改任务的截止日期。
• 标签管理：支持查看和管理 Remember The Milk 任务的标签。

安装步骤

1. 安装 CowGnition: 打开终端，根据您的 Go 环境配置选择以下安装方式之一：

   • 直接安装 (推荐):

     go install github.com/cowgnition/cowgnition@latest
     

   • 从源代码构建:

     git clone https://github.com/cowgnition/cowgnition.git
     cd cowgnition
     make build
     

2. 配置 Remember The Milk API 密钥: 访问 Remember The Milk API 密钥页面 获取您的 'API key' 和 'Shared secret'。

3. 创建配置文件 'config.yaml': 在合适的目录下创建 'config.yaml' 文件，并填入以下内容，替换 'your_api_key' 和 'your_shared_secret' 为您在步骤 2 中获取的密钥：

   server:
     name: "CowGnition RTM" # MCP 服务器名称，可自定义
     port: 8080          # MCP 服务器端口，可自定义
   
   rtm:
     api_key: "your_api_key"       # 替换为您的 RTM API key
     shared_secret: "your_shared_secret" # 替换为您的 RTM Shared secret
   
   auth:
     token_path: "~/.config/cowgnition/tokens" # 授权 token 存储路径，可自定义
   

4. 启动 CowGnition 服务器: 在终端中，使用以下命令启动 CowGnition 服务器，指定配置文件路径：

   ./cowgnition serve --config configs/config.yaml
   

服务器配置 (MCP 客户端配置)

对于 MCP 客户端 (如 Claude Desktop)，您需要配置以下信息以连接 CowGnition 服务器：

{
  "server_name": "Remember The Milk",  // MCP 服务器名称，与 config.yaml 中 server.name 一致，可自定义
  "command": "cowgnition",            // MCP 服务器启动命令
  "args": "serve --config configs/config.yaml" // MCP 服务器启动参数，指定配置文件路径
}

参数说明:

• 'server_name': MCP 服务器的名称，用于在客户端中标识连接。
• 'command': 启动 CowGnition 服务器的可执行文件名称 ('cowgnition')。
• 'args': 启动 'cowgnition serve' 命令所需的参数，这里指定了配置文件的路径。

基本使用方法

1. 连接到 MCP 服务器: 在 MCP 客户端 (如 Claude Desktop) 中，按照客户端的指引安装或连接 MCP 服务器，并填入上述服务器配置信息。

2. 与 AI 助手对话: 连接成功后，即可使用自然语言与 AI 助手对话，例如：

   • "今天有什么任务到期？"
   • "添加牛奶到购物清单"
   • "显示所有标记为 '重要' 的任务"
   • "将牙医预约设置为下周二"
   • "我的工作清单上有什么？"

3. 授权 Remember The Milk: 首次使用时，当您向 AI 助手询问任务相关信息时，CowGnition 服务器会生成一个授权链接。按照提示访问链接并授权 CowGnition 访问您的 Remember The Milk 账户。授权完成后，复制授权码 (frob) 并告知 AI 助手，即可完成连接。