使用说明

项目简介

本项目 'mcp-server-agenda' 是一个 MCP (Model Context Protocol) 服务器的实现，旨在连接 Claude AI 和 macOS 上的 Agenda 应用。通过这个服务器，Claude 能够以标准化的方式调用 Agenda 应用的功能，例如创建笔记、管理项目和打开现有笔记，从而扩展 Claude 在上下文信息处理和外部功能调用方面的能力。

主要功能点

创建笔记: 允许 Claude 在 Agenda 应用中创建新的笔记，支持设置标题、内容、所属项目、以及其他 Agenda 提供的选项（如添加到日程、设置日期等）。
管理项目: 支持 Claude 在 Agenda 应用中创建和管理项目。
打开笔记: 允许 Claude 打开 Agenda 应用中已存在的笔记。
x-callback-url 集成: 服务器通过 Agenda 应用提供的 x-callback-url 方案实现与 Agenda 的功能集成，确保了操作的稳定性和兼容性。

安装步骤

克隆仓库: 首先，使用 Git 克隆 'mcp-server-agenda' 仓库到您的本地计算机。

git clone https://github.com/alexgoller/mcp-server-agenda.git
cd mcp-server-agenda

安装 uv: 确保您已安装 'uv'，这是一个现代 Python 包安装和解析器。如果未安装，请运行以下命令安装：
```
pip install uv
```

创建 pyproject.toml: 在仓库根目录下创建一个 'pyproject.toml' 文件，并将以下内容复制到文件中。这个文件用于配置 Python 项目的构建和依赖管理。

[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 = [
    "flask", # 实际代码中并没有使用flask，这里根据代码中的import添加了mcp库
    "mcp"
]

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

安装项目: 使用 'uv' 安装项目及其依赖。在仓库根目录下运行：
```
uv pip install -e .
```

服务器配置

要让 MCP 客户端（例如 Claude 桌面应用）连接到 'mcp-server-agenda' 服务器，您需要在客户端的配置文件中添加服务器的启动配置。对于 Claude 桌面应用，配置文件通常位于 '$HOME/Library/Application Support/Claude/claude_desktop_config.json'。

将以下 JSON 配置添加到 'claude_desktop_config.json' 文件中。请务必根据您的实际路径修改 'args' 中的目录地址。

{
    "mcp-server-agenda": {  // "mcp-server-agenda" 是您为这个服务器配置自定义的名称，在 Claude 客户端中用这个名字来标识该服务器。
        "command": "uv",      // "command" 指定了启动服务器的命令，这里使用 uv 命令来运行 Python 应用。
        "args": [           // "args" 是传递给 "command" 的参数列表。
            "--directory",    // "--directory" 参数告诉 uv 命令项目所在的目录。
            "/Users/your.username/git/mcp-server-agenda", //  这里需要替换为您的实际仓库路径，指向您克隆的 'mcp-server-agenda' 仓库的根目录。
            "run",            // "run" 是 uv 命令的一个子命令，用于运行一个 Python 应用。
            "mcp-server-agenda" // "mcp-server-agenda"  指定要运行的应用名称，这里对应项目名称。
        ]
    }
}

注意:

请将 '/Users/your.username/git/mcp-server-agenda' 替换为您克隆 'mcp-server-agenda' 仓库的实际本地路径。
确保 Claude 桌面应用能够访问到您指定的仓库路径和 'uv' 命令。

基本使用方法

配置完成后，当 Claude 客户端启动时，它将尝试连接到 'mcp-server-agenda' 服务器。您可以通过 Claude 的界面或指令，利用服务器提供的工具（如创建笔记、项目等）来操作 Agenda 应用。具体的指令和操作方式取决于 Claude 客户端如何使用 MCP 协议与服务器进行交互。您可以在 Claude 的帮助文档或相关指南中查找如何使用外部工具和上下文服务器的详细信息。

关键词