AI导哈

Agenda笔记管理服务

一个通过Claude AI与macOS上的Agenda应用交互的服务器实现，提供创建笔记、管理项目和打开现有笔记的功能。

  • by alexgoller
  • Python
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 alexgoller/mcp-server-agenda

使用说明

mcp服务器议程

通过Claude AI在macOS上与Agenda应用程序交互的服务器实现。此服务器提供了使用x-callback-urls在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能够与服务器交互，请将以下配置添加到位于以下位置的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 使用您的实际主目录路径。

需求

  • macOS
  • Python 3.7+
  • 已安装议程应用程序
  • 紫外线 -现代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. 分叉存储库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add some amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

致谢

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

支持

如需支持，请在GitHub存储库中打开问题或联系维护人员。

相关 MCP