MCP Server Agenda

🚀 mcp-server-agenda 服务器议程插件

mcp-server-agenda 是一个强大的服务器实现，它借助Claude AI，实现了与macOS上的Agenda应用程序的高效交互。该插件支持创建笔记、管理项目，还能通过x-callback-urls在Claude中直接打开现有笔记，极大地提升了笔记管理的便捷性。

🚀 快速开始

mcp-server-agenda 服务器议程插件能够让你通过Claude AI与macOS上的Agenda应用程序无缝交互。以下是使用前的准备步骤：

1. 克隆仓库：

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

✨ 主要特性

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

📦 安装指南

环境要求

• 操作系统：macOS
• Python版本：Python 3.7+
• 应用程序：已安装Agenda应用程序
• 包安装程序：uv - 现代Python包安装程序和解析器

  pip install uv
  

• Python包：必需的Python包（见requirements.txt）

项目设置

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

[project]
name = "mcp-server-agenda"
version = "0.1.0"
description = "与macOS上的Agenda应用程序通过Claude AI交互的服务器实现"
requires-python = ">=3.7"
dependencies = [
    "flask",
    # 在此处添加其他依赖项
]

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

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

uv pip install -e .

Claude Desktop 配置

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

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

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

📚 详细文档

X-Callback-URL 集成

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

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

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

🤝 贡献指南

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仓库中打开问题或联系维护人员。