使用说明

项目简介

mcp-server-agenda 是一个 MCP (Model Context Protocol) 服务器的实现，它允许大型语言模型 (LLM) 客户端（如 Claude AI）与 macOS 上的 Agenda 应用进行集成。通过此服务器，LLM 可以调用工具来创建、管理和访问 Agenda 应用中的笔记和项目，从而实现 AI 驱动的笔记管理和工作流程自动化。

主要功能点

创建笔记: 允许 LLM 在 Agenda 应用中创建新的笔记，可以指定标题、内容、所属项目、日期等多种参数。
管理项目: 支持 LLM 在 Agenda 应用中创建和管理项目。
打开现有笔记: LLM 可以通过此服务器打开 Agenda 应用中已存在的笔记。
x-callback-url 集成: 服务器基于 Agenda 的 x-callback-url 方案实现与 Agenda 应用的交互，确保了功能的完整性和可靠性。

安装步骤

克隆仓库:

git clone https://github.com/MCP-Mirror/alexgoller_mcp-server-agenda.git
cd alexgoller_mcp-server-agenda

安装 'uv' (如果尚未安装): 'uv' 是一个现代 Python 包安装器，用于管理项目依赖。
```
pip install uv
```

创建 'pyproject.toml' 文件: 如果仓库根目录下没有 'pyproject.toml' 文件，请手动创建一个，并将以下内容复制进去，用于声明项目依赖和构建信息。

[project]
name = "mcp-server-agenda"
version = "0.1.0"
description = "A server implementation for interacting with the Agenda app on macOS through Claude AI"
requires-python = ">=3.7"
dependencies = [
    "mcp-server", # MCP 服务器库
    # 其他依赖可能会在 requirements.txt 中列出，请根据需要添加到这里
]

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

安装项目依赖: 使用 'uv' 安装项目依赖，并以可编辑模式安装当前项目。
```
uv pip install -e .
```

服务器配置

要使 MCP 客户端（例如 Claude 桌面应用）能够连接到此 MCP 服务器，您需要在客户端的配置文件中添加服务器的启动配置。对于 Claude 桌面应用，配置文件通常位于 '$HOME/Library/Application Support/Claude/claude_desktop_config.json'。将以下 JSON 配置添加到该文件中的适当位置（例如，'servers' 字段下，如果存在）。

{
    "mcp-server-agenda": {  // 服务器名称，客户端通过此名称识别服务器
        "command": "uv",      // 启动服务器的命令，这里使用 uv 运行 Python 模块
        "args": [             // 启动命令的参数列表
            "run",            // uv run 子命令，用于运行 Python 包或模块
            "mcp-server-agenda" // 要运行的 Python 模块名，对应于项目中的 mcp_server_agenda 包
        ]
    }
}

注意:

'server name' (例如 "mcp-server-agenda") 是您在客户端配置中引用的服务器标识符，可以自定义，但需要与配置 JSON 中的键名保持一致。
'command' 和 'args' 指定了如何启动 MCP 服务器进程。这里配置假定您已安装 'uv' 并将其添加到了系统 PATH 环境变量中。 'uv run mcp-server-agenda' 命令会执行 'mcp_server_agenda' 包中的 'main' 函数，该函数在 'src/mcp_server_agenda/init.py' 中定义并调用了 'server.main()' 函数，从而启动 MCP 服务器。

基本使用方法

确保已安装 macOS Agenda 应用。
按照上述安装步骤完成 mcp-server-agenda 服务器的安装和配置。
启动 Claude 桌面应用（或其他 MCP 客户端）。
在 Claude 中，您应该能够配置并连接到名为 'mcp-server-agenda' 的 MCP 服务器。
连接成功后，Claude 就可以使用此服务器提供的工具，例如：
- 在 Prompt 中指示 Claude "创建一个标题为 '会议记录'，内容为 '讨论了项目进展' 的 Agenda 笔记"。
- Claude 可能会调用 'create-agenda-note' 工具，并将标题和内容作为参数传递给 MCP 服务器。
- MCP 服务器接收到请求后，会通过 x-callback-url 调用 Agenda 应用的 'create-note' 接口，在 Agenda 中创建笔记。
- Claude 接收到服务器的响应，并可以将操作结果反馈给用户。

通过这种方式，LLM 客户端可以利用 mcp-server-agenda 服务器作为桥梁，与 macOS Agenda 应用进行深度集成，实现更智能化的笔记管理和工作流程。

关键词