mcp-server-agenda
2024.12.10
1
Python笔记管理项目管理AI集成日程管理
mcp-server-agenda 是一个用于通过 Claude AI 与 macOS 上的 Agenda 应用交互的服务器实现。该服务器提供了创建笔记、管理项目以及通过 x-callback-urls 打开现有笔记的功能。
View on GitHub
Overview
基本能力
产品定位
mcp-server-agenda 是一个专为 macOS 设计的服务器，用于通过 Claude AI 与 Agenda 应用进行交互，提供笔记和项目管理功能。
核心功能
- 在 Agenda 中创建笔记，支持标题、文本、日期、模板等多种选项
- 在 Agenda 中创建和管理项目
- 直接从 Claude 打开现有笔记
- 完全支持 Agenda 的 x-callback-url 方案
适用场景
- 通过 AI 驱动的方式管理个人或团队的日程和笔记
- 自动化创建和打开 Agenda 笔记
- 与 Claude AI 集成，实现智能化的笔记管理
工具列表
- uv: 现代 Python 包安装器和解析器，用于安装和管理项目依赖
- Flask: 用于构建服务器的 Python Web 框架
常见问题解答
- 如何配置 Claude 与服务器交互？ 需要在 Claude 桌面配置文件中添加服务器配置，指定 uv 命令和服务器路径。
- 需要哪些前置条件？ 需要 macOS 系统、Python 3.7+、Agenda 应用安装以及 uv 工具。
使用教程
使用依赖
- 安装 uv:
bash pip install uv - 确保已安装 Agenda 应用
安装教程
- 克隆仓库:
bash git clone https://github.com/yourusername/mcp-server-agenda.git cd mcp-server-agenda - 创建 pyproject.toml 文件并添加必要配置
- 安装项目依赖:
bash uv pip install -e .
调试方式
- 启动服务器:
bash uv run mcp-server-agenda - 检查 Claude 配置是否正确指向服务器路径
- 测试创建笔记或打开现有笔记功能是否正常工作