mcp-server-agenda

这是一个用于通过Claude AI与macOS上的Agenda应用进行交互的服务器实现。该服务器提供了创建笔记、管理项目以及使用x-callback-urls在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 = "一个用于通过Claude AI与macOS上的Agenda应用进行交互的服务器实现"
requires-python = ">=3.7"
dependencies = [
    "flask",
    # 在此处添加其他依赖项
]

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

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

uv pip install -e .

贡献

1. 分叉仓库
2. 创建您的功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m '添加一些精彩的功能'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 打开拉取请求

许可证

本项目采用MIT许可证 - 详情请参阅LICENSE文件。

致谢

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

支持

如需支持，请在GitHub仓库中打开一个问题或联系维护者。