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倉庫中打開問題或聯繫維護人員。