mcp-server-agenda

mcp-server-agenda

site icon
2024.12.27 0
Python笔记管理项目管理自动化日程管理
mcp-server-agenda 是一个用于通过 Claude AI 与 macOS 上的 Agenda 应用交互的服务器实现。该服务器提供了创建笔记、管理项目以及通过 x-callback-urls 打开现有笔记的功能。
View on GitHub

Overview

基本能力

产品定位

mcp-server-agenda 是一个用于与 macOS 上的 Agenda 应用交互的服务器,主要用于通过 Claude AI 进行笔记管理和项目管理的自动化操作。

核心功能

  • 在 Agenda 中创建笔记,支持多种选项(标题、文本、日期、模板等)
  • 在 Agenda 中创建和管理项目
  • 直接从 Claude 打开现有笔记
  • 完全支持 Agenda 的 x-callback-url 方案

适用场景

  • 通过 AI 自动化管理个人或团队的日程和笔记
  • 快速创建和打开 Agenda 笔记
  • 项目管理自动化

工具列表

  • uv: 现代 Python 包安装器和解析器,用于安装和管理项目依赖
  • Flask: 用于构建服务器的 Python Web 框架

常见问题解答

  • 如何配置 Claude 桌面以与服务器交互? 需要在 Claude 桌面配置文件中添加服务器配置,具体路径为 $HOME/Library/Application Support/Claude/claude_desktop_config.json

  • 项目需要哪些前置条件? 需要 macOS 系统、Python 3.7+、已安装的 Agenda 应用以及 uv 工具。

使用教程

使用依赖

  1. 安装 uv: bash pip install uv

  2. 确保已安装 Python 3.7+ 和 Agenda 应用。

安装教程

  1. 克隆仓库: bash git clone https://github.com/yourusername/mcp-server-agenda.git cd mcp-server-agenda

  2. 创建 pyproject.toml 文件并配置项目依赖。

  3. 安装项目依赖: bash uv pip install -e .

调试方式

  1. 启动服务器: bash uv run mcp-server-agenda

  2. 确保 Claude 桌面配置正确,可以尝试创建笔记或打开现有笔记进行测试。

许可证

该项目遵循 MIT 开源许可条款。