mcp-server-agenda

mcp-server-agenda

镜像

概述

mcp-server-agenda 是一个服务器实现,允许通过 Claude AI 与 macOS 上的 Agenda 应用程序交互,提供创建笔记、管理项目和打开现有笔记的功能。

安装步骤

git clone https://github.com/yourusername/mcp-server-agenda.git
cd mcp-server-agenda
uv pip install -e .

配置 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+
  • Agenda 应用
  • uv 包管理器 (pip install uv)

主要功能

  • 创建笔记 (create-note)
  • 打开笔记 (open-note)
  • 创建项目 (create-project)

项目配置

创建 pyproject.toml 文件:

[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",
    # 添加其他依赖项
]

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

更多信息

有关 Agenda x-callback-url 方案的详细信息,请参阅官方文档