mcp-server-agenda

一个服务器实现，用于通过 Claude AI 与 macOS 上的 Agenda 应用进行交互。此服务器提供工具来创建笔记、管理项目，并使用 x-callback-url 在 Agenda 中打开现有笔记。

功能

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

安装

1. 克隆仓库：

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

使用

X-Callback-URL 集成

此服务器利用 Agenda 的 x-callback-url 方案与应用进行交互。支持的操作包括：

• create-note
• open-note
• create-project

有关 Agenda 的 x-callback-url 方案的更多信息，请访问他们的文档。

配置

Claude 桌面配置

要使 Claude 能够与服务器交互，请将以下配置添加到位于 $HOME/Library/Application Support/Claude/claude_desktop_config.json 的 Claude 桌面配置文件中：

{
    "mcp-server-agenda": {
        "command": "uv",
        "args": [
            "--directory",
            "/Users/your.username/git/mcp-server-agenda",
            "run",
            "mcp-server-agenda"
        ]
    }
}

请确保将 /Users/your.username 替换为您实际的主目录路径。

要求

• macOS
• Python 3.7+
• 已安装 Agenda 应用
• uv - 现代 Python 包安装器和解析器

  pip install uv
  

• 必需的 Python 包（请参阅 requirements.txt）

项目设置

该项目需要一个 pyproject.toml 文件才能使 uv 正常工作。在根目录中创建一个：

[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",
    # Add other dependencies here
]

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

设置 pyproject.toml 后，您可以使用以下命令以开发模式安装项目：

uv pip install -e .

贡献

1. Fork 仓库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

许可证

此项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

鸣谢

• 感谢 Agenda 团队提供 x-callback-url 支持
• 受 AI 驱动的笔记管理需求的启发

支持

如需支持，请在 GitHub 仓库中打开一个 issue 或联系维护人员。