mcp-server-agenda

mcp-server-agenda

一个模型上下文协议服务器,用于通过x-callback-url接口与日程笔记软件进行交互。

概述

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

安装步骤

  1. 克隆仓库并进入目录:

    git clone https://github.com/你的用户名/mcp-server-agenda.git
    cd mcp-server-agenda
    
  2. 安装依赖:

    pip install uv
    uv pip install -e .
    

配置

  1. 创建 pyproject.toml 文件(如果不存在):

    [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"
    
  2. 配置 Claude Desktop: 在 $HOME/Library/Application Support/Claude/claude_desktop_config.json 添加:

    {
        "mcp-server-agenda": {
            "command": "uv",
            "args": [
                "--directory",
                "/Users/你的用户名/git/mcp-server-agenda",
                "run",
                "mcp-server-agenda"
            ]
        }
    }
    

    注意:请将路径中的用户名替换为你的实际用户名

主要功能

  • 创建笔记(支持标题、文本、日期、模板等选项)
  • 创建和管理项目
  • 打开现有笔记
  • 完全支持 Agenda 的 x-callback-url 方案

系统要求

  • macOS
  • Python 3.7+
  • Agenda 应用程序
  • uv 包管理器

更多信息

有关 Agenda 的 x-callback-url 功能详情,请参阅官方文档

如需支持,请在 GitHub 仓库中提交问题。