AI导哈

痴呆友好日历助手

一个简单友好的日历助手，帮助痴呆症患者通过自然对话轻松管理日程。

  • by prachi-b-modi
  • Shell
  • 本地部署
  • 更新于
在 GitHub 查看 prachi-b-modi/calendar_terminal_mcp_nemo_agent_toolkit_nemotron

使用说明

您的伙伴——痴呆友好型日历助手

一个使用NeMo Agent Toolkit构建的简洁友好的日历助手，帮助痴呆症患者通过自然对话轻松管理他们的日历。

特点/特性

  • 自然对话自然地聊聊你的日程安排
  • 简单的提醒问“接下来有什么安排？”或者“我今天有什么事情要做吗？”
  • 轻松创建活动就说“我明天下午两点有个医生预约”
  • 记忆辅助你的Buddy会记住你的活动，所以你不用记
  • 语音友好设计为与语音助手完美配合使用

先决条件

  1. NVIDIA API密钥从……那里拿一个 build.nvidia.com（可译为“英伟达构建服务器”或保持原样，具体取决于上下文是否需要具体解释该域名）

  2. Google Cloud 设置:

    • 首选 Google Cloud 控制台
    • 创建一个新项目或选择一个现有项目
    • 启用Google日历API
    • 创建OAuth 2.0凭据（桌面应用程序类型）
    • 下载凭据文件为 gcp-oauth.keys.json

  3. Node.js适用于Google日历MCP服务器（版本18或更高）

  4. NeMo Agent 工具包请遵循主README文件中的安装说明

快速入门

步骤1：设置NVIDIA API密钥

您需要一个NVIDIA API密钥才能使用LLM。请通过以下方式设置：

# Set your NVIDIA API key (do this first!)
export NVIDIA_API_KEY=<your_api_key_here>

或者使用辅助脚本：

# This will prompt you for your API key
source ./set_api_key.sh

从以下位置获取您的API密钥： build.nvidia.com（可直接作为域名翻译，表示“英伟达构建服务器”或类似含义，具体翻译可能根据上下文有所调整）

步骤2：启动Google日历MCP服务器

Google 日历 MCP 服务器提供日历访问功能。在终端中启动它：

# Using mcp-proxy to run on port 3500 (recommended)
npx mcp-proxy npx @cocal/google-calendar-mcp --port 3500

这将会：

  1. 提示您使用Google进行身份验证（仅限首次）
  2. 在端口3500上启动MCP服务器
  3. 为你的好友提供日历工具

第三步：运行你的小伙伴（程序/应用）

在新的终端窗口中，确保您已设置您的NVIDIA_API_KEY，然后：

# Simple method using the run script
cd your_buddy
./run.sh "What do I have scheduled today?"

或者手动运行：

# Make sure NVIDIA_API_KEY is set
cd /path/to/nemo-agent-toolkit
source .venv/bin/activate
nat run --config_file ../your_buddy/config.yml --input "What do I have scheduled today?"

如何利用你的伙伴

示例对话

查看你的日程安排：

  • “我今天有什么安排？”
  • “我这周有什么活动吗？”
  • “接下来有什么安排？”
  • “我明天下午有空吗？”

创建事件：

  • “我明天下午2点有个医生预约”
  • “每天早上9点提醒我吃药”
  • “周五中午与莎拉一起吃午饭”

获取当前时间：

  • “现在几点了？”
  • “今天几号了？”

与 Docker 一起使用（替代设置）

如果你更喜欢使用 Docker：

# Start the Google Calendar MCP server with Docker
cd your_buddy
docker compose up -d

# Run Your Buddy
nat run --config_file config.yml --input "What's on my calendar?"

重新认证

如果您看到认证错误，请使用以下方式重新认证：

export GOOGLE_OAUTH_CREDENTIALS="/path/to/your/gcp-oauth.keys.json"
npx @cocal/google-calendar-mcp auth

故障排除

“NVIDIA API密钥未找到”或代理无响应

这是最常见的问题！代理需要您的NVIDIA API密钥才能工作。

解决方案：

# Set your API key (get it from https://build.nvidia.com)
export NVIDIA_API_KEY=<your_nvidia_api_key>

# Verify it's set
echo $NVIDIA_API_KEY

# Then run the agent
./run.sh "What do I have today?"

“未找到MCP服务器”或“MCP服务器未运行”

Google 日历 MCP 服务器需要在 3500 端口上运行。

解决方案：

# In a separate terminal, start the MCP server with mcp-proxy
npx mcp-proxy npx @cocal/google-calendar-mcp --port 3500

# Or check if it's already running
curl -s http://localhost:3500/sse

“nat: command not found”翻译成中文是：“nat：命令未找到”

NAT虚拟环境未激活。

解决方案： 这个（或“该”） run.sh 脚本现在会自动处理这一点。但如果手动运行：

cd /path/to/nemo-agent-toolkit
source .venv/bin/activate
nat run --config_file ../your_buddy/config.yml --input "Your query"

“身份验证失败”（Google 日历）

  • 验证您的 GOOGLE_OAUTH_CREDENTIALS 路径正确
  • 运行： npx @cocal/google-calendar-mcp auth
  • 确保您的电子邮件已在Google Cloud Console中添加为测试用户

为痴呆症用户设计

“Your Buddy”的设计初衷是考虑到痴呆症患者的需求：

  1. 简单明了的语言使用清晰、日常的词汇
  2. 患者的反应需要花时间把事情解释清楚
  3. 适合重复使用不介意被多次问到同一个问题
  4. 情境感知记得刚才讨论过的内容
  5. 低认知负荷一次专注于一件事

定制化

编辑 config.yml 收件人：

  • 调整大型语言模型（LLM）的温度参数以获得更具/较少创造力的回复
  • 添加额外的日历功能
  • 调整助手的性格
  • 添加更多工具（提醒、联系人等）

支持

对于问题或疑问：

  1. 检查一下 NeMo Agent Toolkit 文档
  2. 审查/回顾 Google 日历 MCP 文档
  3. 在相应的仓库中打开一个问题（或提交一个议题）

相关 MCP